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PREFACE 


Here is the information you will need in order to use the Configured 
iRMX 86 Operating System (iRMX 86 PC), a ready-to-use version of Intel's 
general, configurable iRMX 86 Operating System. "Ready-to-use” means 
that Intel has selected the individual software features and then put 
this system software together. In order to do so, we have made some 
assumptions about the hardware on which you will run the system, and we 
describe this hardware in the manual. The iRMX 86 PC product allows you 
to use the Operating System as soon as you have the correct hardware 
environment, without going through the configuration process. 


READERS AND CONTENTS OF THIS MANUAL 


Except for Chapter 5, this manual is written for programmers who will use 
the Operating System. Chapter 5 is written for a hardware technician or 
engineer who assembles the hardware, if the programmer is not the person 
who does this. 


Here is how the manual is organized. 


Chapter 1 


Chapter 2 


Chapter 3 


Chapter 4 


Chapter 5 


OVERVIEW. This chapter describes the characteristics 
of the Operating System. You will ^ant to read~ thia” 
chapter to become familiar with iRMX 86 concepts and 
terms. 

USING THE SYSTEM. This chapter shows how to start up 
(bootstrap load) the Operating System, and shows 
examples of iRMX 86 Commands. 

iRMX 86 COMMANDS. This chapter contains complete 
descriptions of the iRMX 86 Commands, arranged 
alpabetically. 

UDI SYSTEM CALLS. This chapter contains general 
information about the Universal Development Interface 
(UDI) , followed by descriptions of each UDI System 

Call. 

PREPARING YOUR HARDWARE. This chapter describes the 
hardware required to run the Operating System, and how 
to prepare that hardware. 
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PREFACE (continued) 


Appendix A This appendix lists the codes that the iRMX 86 
Operating System uses to indicate exceptional 
eonditions, such as hardware failures and mistakes in 
how a program uses the system. 

Appendix B This appendix provides a list of "internal” iRMX 86 
System Calls. You will not need to use these system 
calls to write and run programs. But the information 
in this appendix provides an overview of the services 
provided by the iRMX 86 Operating System. 

Appendix C This appendix describes how to use the monitor that is 
delivered as part of the iRMX 86 PC System. 


WHAT YOU GET 

The iRMX 86 PC Release Package contains: 

• The System Diskette, which is labeled 

Preconfigured iRMX 86 Operating System 
m~ The iLilbrary Diskette, which is labeled 
iRMX 86 Interface Libraries 

• Four (4) EPROM devices which contain the Monitor and a Bootstrap 
Loader (you install these on your iAPX 86 Single Board 
Computer) 

• This manual 

• One Software Problem Report Form 

• One Software Registration Card, which you should complete and 

return when you receive the package 
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PEtEFACE (continued) 


RELATED PUBLICATIONS 

The following manuals provide additional information that may be helpful 
to users of this manual. These manuals are described in Chapter 6. 


Manual Number 

Introduction to the iRMR” 86 Operating System 9803124 

iRMX" 86 Nucleus Reference Manual 9803122 

iRMX" 86 Basic I/O System Reference Manual 9803123 

iRMX’" 86 Extended I/O System Reference Manual 143308 

iRMX" 86 Loader Reference Manual 143318 

iRMX" 86 Human Interface Reference Manual 9803202 

IRMX" 86 Disk Verification Utility Reference Manual 144133 

iRMX" 86 System Programmer's Reference Manual 142721 

iRMX" 86 Programming Techniques Manual 142982^ 

Guide to Writing Device Drivers for the iRMX" 86 and 

iRMX" 88 I/O Systems 142926 

iRMX" 86 Configuration Guide 9803126 

iRMX" 86 Installation Guide 9803125 

EDIT Reference Manual 143587 

Guide to Using iRMX" 86 Languages 143907 

8086/8087/8088 Macro Assembly Language Reference Manual for 

8086-Based Development Systems 121627 

8086/8087/8088 Macro Assembler Operating Instructions for 

8086-Based Development Systems 121628 

PL/M-86 User's Guide for 8086-Based Development Systems 121636 
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Manual Number 

FORTRAN-86 User’s Guide 121570 

Pascal-86 User's Guide 121539 

lAPX 86,88 Family Utilities User's Guide 121616 

Run-Time Support Manual for lAPX 86, 88 Applications 121776 

User's Guide for the ISBC® 957B lAPX 86, 88 Interface and 

Execution Package 143979 

ISBC® 86/12A Single Board Computer Hardware Reference Manual 9803074 

ISBO® 86/14 and ISBC® 86/30 Single Board Computer Hardware Reference 

Manual 144044 

iSBX" 208 Flexible Disk Drive Controller Hardware Reference 

Manual 143078 

ISBC® 337 Multlmodule* Numeric Data Processor Hardware 

Reference Manual 142887 
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CHAPTER 1. SYSTEM OVERVIEW 


The iRMX 86 Operating System manages and extends the resources of iSBC 86 
Single Board Computers. Figure 1-1 shows the structure of the Operating 
System; the "layers** of the system are described in Appendix B. The 
iRMX 86 PC Operating System — a version of the general, configurable 
Operating System — is specifically designed to allow you to develop and 
run programs. The features of the Operating System that are described in 
this chapter are: 

• Support for language translators and utilities, including a 
standard software interface that simplifies addition of software 
packages to your system 

• The iRMX 86 file system, including file utilities and system 
calls to manipulate files 

• Mechanisms to bootstrap load the Operating System and to load and 
run programs 

• Er r o r-h and ling procedures 

Since you will have to prepare the hardware on which the Operating System 
runs, the first section describes this hardware environment. 



Figure 1-1. iRMX™ 86 Operating System Layers 
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HARDWARE ENVIRONMENT FOR THE IRMX 86 PC SYSTEM 


The iRMX 86 PC System software Is already configured for you. This 
section describes the hardware on which you will install the Operating 
System. Figure 1-2 shows the hardware, and Figure 1-3 shows a memory 
layout. Chapter 5, HOW TO PREPARE YOUR HARDWARE, is a self-contained 
guide to setting up this hardware. 


2732A EPROMS 
(with Bootstrap Loader 
and Monitor) 



CHASSiSiPOWER SUPPLY 


SYSTEM DISKETTE 


Backplane with 
MULTIBUS'^ 
Connectors 


FLEXIBLE DISK CONTROLLER 


PROCESSOR BOARD 


VIDEO TERMINAL 


MEMORY BOARD(S) 


Figure 1-2. iRMX" 86 PC Hardware Environment 
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SYSTEM OVERVIEW 


To use the iRMX 86 PC Operating System, you require the following 
hardware components : 

• an Intel iSBC 86/12A, iSBC 86/14, or iSBC 86/30 Single Board 
Computer 

• an iSBC 208 diskette controller with at least two drives (you can 
connect as many as four drives) 

• a video terminal 

• an appropriate chassis/power-supply unit 

In addition, you can connect either a line printer or_ an iSBC 957B 
package to the parallel port on the computer board. The iSBC 957B 
package allows you to connect your system directly to an Intellec 
Microprocessor Development System. Neither the line printer nor the 
iSBC 957B package is required to run the Operating System. 

Figure 1-3 shows a memory layout. The area labelled FREE SPACE is where 
your programs and iRMX 86 utilities (the commands described in Chapters 2 
and 3) run. The question mark (?) on the drawing indicates that it is 
your choice how much free space you have on your system. You will need 
about 32K-bytes of free space to run the iR^lX 86 commands, and more 
memory to run Intel compilers. 


ADDRESS 

(hex) 


SIZE 
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9 


30000 


00000 


BOOTSTRAP AND 
MONITOR (ROM) 
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ADDRESS 

SPACE 


FREE SPACE 
(RAM) 


iRMX 86 

OPERATING SYSTEM 
(RAM) 


I 16K BYTES: on EPROM 
J devices delivered with 
system 


Your programs and 
system utilities 


> 19K BYTES: 

(from system diskette) 


Figure 1-3. Memory Layout of iRMX” 86 System 


1-3 






SYSTEM OVERVIEW 


LANGUAGE TRANSLATORS AND UTILITIES 

To develop programs you need language translators and utilities that 
allow you to compile or assemble programs, link programs together, assign 
absolute addresses to programs, create libraries of programs, and convert 
absolute object modules to hexadecimal format. Software packages 
available from Intel include: 


EDIT 
ASMS 6 
PLM86 
LINK86 

LOC86 

LIB86 


The standare IRMX 86 editor. 

The 8086/8087/8088 macro assembler. 

The PL/M~86 compiler. 

The 8086 Linker, which combines individually-compiled 
object modules into a single, relocatable object module. 

The 8086 Locater, which assigns absolute addresses to 
relocatable object modules. 

The 8086 Li brarian, which creates and maintains object 
module libraries. 


0H86 A program which converts absolute object modules to 

hexadecimal format. 

Pascal-86 A Pascal compiler that is a strict Implementation of the 
proposed ISO standard. It also provides extensions of 
the language for microcomputers . 

FORTRAN-8 6 A FORTRAN compiler that is compatible with existing 

FORTRAN-86 code, and also includes new FORTRAN- 7 7 
language features. 


With these products you can create executable programs that can be 
invoked from the terminal. If you are an OEM (original equipment 
manufacturer) you can Include these languages with your end product. 

You can refer to the GUIDE TO USING iRMX 86 LANGUAGES for general 
information about invoking language products in an iRMX 86 environment . 
For detailed information about the software products listed here, you 
should refer to the manuals for the individual products. Chapter 5 
contains a list of manuals assoaciated with the iRMX 86 Operating System. 

Contact your local Intel sales representative or distributor to order any 
of these software packages. 
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UNIVERSAL DEVELOPMENT INTERFACE 

The iRMX 86 PC Operating System supports the Universal Development 
Interface (UDI). The UDI provides a standard method for your programs 
and for Intel software packages to use Operating System services. The 
UDI can be viewed as a "software bus," with the set of UDI system calls 
being equivalent to a hardware bus protocol. There are three important 
advantages to using UDI software. 

• INDEPENDENCE FROM OPERATING SYSTEM CHANGES . The set of system 
calls for UDI remain stable regardless of changes in the 
Operating System, so software that you develop or install on your 
system can remain intact. 

• ability . With the UDI "software bus", a language translator, 
utility, or any other software package that uses only UDI system 
calls to communicate with the underlying Operating System can be 
installed on any operating system that supports UDI. 

m INDEPENDENT VENDOR^ S SOFTWARE . The UDI standard allows 

independent software vendors to provide a variety of programs 
that run on the iRMX 86 Operating System. 

Chapter 4 describes how to use the UDI system calls that are available on 
your iRMX 86 PC Operating System. 


THE iRMX 86 FILE SYSTEM 


A fundamental function of the iRMX 86 Operating System is to provide a 
file system. Programs you write, as well as utilites and language 
processors, need to create and delete files; to open, close, read, and 
write files; and to perform other file operations. These files exist on 
mass storage devices such as flexible diskettes. This section describes 
the major characteristics of the iRMX 86 file system. 


HIERARCHICAL NAMING OF FILES 

People manipulate files with commands invoked from a terminal; programs 
manipulate files with system calls. The iRMX 86 Operating System allows 
your application system to organize its named files into a tree-like 
structure like the one shown in Figure 1-4. This hierarchical structure 
consists of files (represented by triangles in the figure) and 
directories (represented by rectangles in the figure). This hierarchy 
allows data to be grouped logically and accessed with a minimum of 
overhead. 
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BATCH-1 BATCH-2 


Figure 1-4. Hierarchical File Structure 


IRMX 86 FILE TERMINOLOGY 

Here are the meanings of terms used to describe the iRMX 86 file system: 

• Fil^: In a computer system, a file is simply a collection of 

related data known by a single name. Typically, files reside on 
secondary storage such as disks. An iRMX 86 file name is the 
last component of a pathname that implicitly or explicitly 
identifies the volume and directory to which the file belongs. 

• Volume : A volume is a secondary storage device, such as a 

diskette, hard disk platter, or a bubble memory that you have 
formatted to accept files and directories. Before you can use a 
new volume, that volume must be formatted by using the Human 
Interface FORMAT command (see the FORMAT command description in 
Chapter 3). 
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• Directory ; A directory is used to catalog (that is, to logically 
group and locate) files and other directories. You do not 
directly place information in directories as you do in a file. 
Rather, the Operating System maintains the directory information, 
adding, deleting, or changing directory entries as you add, 
delete, or rename files that are cataloged in the directory. 

Like files, directories are identified by pathnames. Files and 
directories contained within a particular directory must be on 
the same volume as the directory. 

• Pathname : Normally, both system calls and commands identify a 

file or directory with a pathname . Pathnames can be viewed as 
the exact name of a file or directory. A pathname describes one 
path through the directory tree, so that it specifies not only 
the name of a file or directory, but also the particular 
directories and device to which it belongs. 

Referring again to Figure 1-4, the name "BILL” is not exact, 
because there are two directories named Bill. But the pathname 
DEPTl/BILL is valid because it is unique. (Slash (/) characters 
separate the elements of a pathname. ) The pathname 
DEPT 1 /TOM/TEST-OBJECT is a valid identifier for a file. 

^ l»Qg^cal Name ; Logical names are used to identify devices, and 
are delimited by colons (;); for example, ;LP;. You assign 
logical names to physical devices with the ATTACHDEVICE command 
(see Chapter 3). Logical names that the iRMX 86 PC Operating 
System has already assigned to devices are described in the next 
section. 

The reason logical names are used to Identify devices is so that 
the same name can be used for a device even if the device is 
changed. For example, the iRMX 86 PC System is delivered on a 
single-sided, double-density diskette, and it is assumed that at 
the first two drives on your system have this characteristic. 

But it is possible to add one or two more drives, or to use the 
same drives with other physical characteristics (if you do the 
latter, you will first have to create a System Diskette in the 
new format) . In this case you attach each drive (using the 
ATTACHDEVICE command) with a physical name appropriate to the 
characteristics of the drive. These name are listed in Chapter 
5, PREPARING YOUR HARDWARE. 


DEVICE LOGICAL NAMES 

The logical names for devices that are used with the iRMX 86 PC Operating 
System are 

;CI; and "Console Input" and "Console Output”. Logical devices 
;C0; that establish the source of commands and the command 

destination, respectively. Typically, ;CI; is the 
terminal keyboard and ;C0; is the terminal screen. 
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:I.P: 

:BB: 


:AFD0: 

:AFD1: 


**Line Prlpter”. This is the logical name for the line 
printer. 

"Byte-Bucket”. This is not an actual physical device. 
Anything written to :BB: disappears, and a read from 
:BB: returns an EOF (end-of-file) . 

Logical names for the iSBC 208 flexible disk drives 0 
and 1. 


FILE OPERATIONS FROM A TERMINAL 

You manipulate iRMX 86 files and directories interactively with programs 
run from a terminal; the programs are Invoked as single word commands 
followed by parameters. The iRMX 86 Operating System provides programs 
to perform operations that are usually necessary in a development 
system. These include: 

• COPY, which copies files 

• DIR, which displays the contents of a particular directory 

• RENAME, which gives a new name to a file or directory 

• CREATEDIR, which creates a new file directory 

• SUBMIT, which automatically executes other commands contained in 
a file 

Chapter 2 describes how to invoke commands and shows examples of some 
commands. Chapter 3 describes all of the commands. 


FILE OPERATIONS FROM PROGRAMS 

Programs must be able to manipulate files. An assembler, for example, 
must open and read source files, and it must create and write object 
files. Programs that you write will read, write, delete, and otherwise 
deal with files. Your programs perform these operations by means of UDI 
system calls. In addition to file operations, other Operating System 
services are available with UDI system calls. Chapter 4 contains the 
information you need to use UDI system calls, including individual 
descriptions of each call that is provided with the iRMX 86 PC Operating 
System. The chapter ends with a listing of a program that uses many of 
the UDI system calls. 
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FILES AND DIRECTORIES SUPPLIED WITH THE IRMX 86 PC OPERATING SYSTEM 

The iRMX 86 PC Package contains two diskettes, a System Diskette, and a 
Library Diskette. The identifying labels on the outside of each are 
specified in the Preface. 


SYSTEM DISKETTE 

Figure 1-5 shows the file structure of the iRMX 86 PC System Diskette as 
it is delivered from Intel. The elements of this file structure are 
explained below. 



DIRECTORY 



FILE 


Figure 1-5. iRMX” 86 PC File and Directory Structure 
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Default Directory ($) 

The uppermost ( root ) directory on Drive 0 is the default directory. If 
you do not specify a directory, the system will assume you are referring 
to this one. The root directory of a volume contains all other 
directories that are on the volume. 


System Directory (SYSTEM) 

This directory contains the following directories and files: 

• iRMX 86 COMMAND PROGRAMS . When you type an iRMX 86 Command at a 
terminal, one of the programs in this directory is loaded and 
run. For example, the command "COPY” runs the program of the 
same name. Only a few representative command files are shown in 
Figure 2-4. There are 17 commands delivered with the system. 

• operating system. The file RMX86 contains the 1RMX86 PC 
Operating System; this is the file that is read in by the 
Bootstrap Loader (see BOOTSTRAP LOADING in a later section). 

• UP I LIBRARIES . The directory UDI contains three library files 
that allow programs to use the UDI system calls. When you use a 
language processor like the P’L/M-86 compiler to write a program, 
you link the resultant object modules to one of these libraries. 
This is explained more fully in Chapter 4. 


Program Directory (PROG) 

You can use this directory for programs that you write, and you can 
create other directories within this one to provide a logical grouping of 
your files. 

The PROG directory has one special characteristic. When you type a 
single-word command at a terminal, the IRMX 86 Operating System will 
first look for the program file with that name in the default directory, 
then in the PROG directory, and finally in the SYSTEM directory. Two 
effects of this are: 

1. Programs in the PROG directory will be executed as commands when 
you simply type the single-word file name. For example, if you 
have a program file PROG/UPPER, you can run the program by simply 
typing the command UPPER. 

2. If you have a program named, for example, ’’COPY" in the PROG 
directory, when you type "COPY" the system runs your program 
rather than the COPY program supplied by Intel. 

If a program file is contained in a directory other than one of these 
three ($, PROG, or SYSTEM), you can still run the program by typing its 
complete pathname. 
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Work Directory (WORK) 

Coii 5 )ilers, interpreters, editors, linkers, and other development 
utilities need to create temporary files while they are running. This 
directory is specifically provided for that use. 


LIBRARY DISKETTE 

Besides the System Diskette, you receive another diskette with the 
IRMX 86 PC product, labelled "iRMX 86 Interface Libraries." This 
diskette contains: 

• Libraries that you need if you use iRMX 86 System Calls not 
described in Chapter 4 (these calls are listed in Appendix B). 

• Files of symbolic names for exception codes (listed in Appendix 
A). 

• Files of external declarations associated with each layer of the 
Operating System (the layers are briefly described in Appendix B). 

The Library Diskette is not required for normal program development. If 
you use these files, you will probably need one or more of the manuals 
listed in Chapter 6. 


PROGRAM LOADING 

Bringing programs into memory (loading) from the disk is one of the basic 
services provided by the IRMX 86 Operating System; you load and run 
language processors, utilities, and the programs you write. Typically, 
you load programs by simply typing the single-word name of a program file 
at a terminal, sometimes followed by other information needed by the 
program when it begins executing. 


BOOTSTRAP LOADING 

To get the iRMX 86 PC Operating System into the computer from disk, the 
system is bootstrap loaded. This process is described in Chapter 2. The 
Bootstrap Loader is in the set of EPROM devices delivered with the 
IRMX 86 PC Package. 
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MONITOR 


Your iRMX 86 PG System is delivered with a Monitor* Like the Bootstrap 
Loader, the Monitor is in EPROM devices you receive with the iRMX 86 PC 
Package. It can be used to examine memory, set breakpoints, and (with a 
hardware package available separately) to communicate between your system 
and an Intellec Development System. 

Monitor commands are described in Appendix C. 


SELECTIVE ERROR PROCESSING 

When a program issues an IRMX 86 system call, the results may be other 
than what the programmer expected* For example, a program might request 
memory that is not available, or it might use an invalid parameter. The 
iRMX 86 PC Operating System contains a default exception handler that 
will terminate a program if such a condition occurs; the default 
exception handler will identify the problem by displaying on the console 
terminal one of the exception codes listed in Appendix A. 

If you want to provide your own exception handler, rather than using the 
default exception handler, the Operating System provides a mechanism for 
transferring control to your exception handler. The system calls used to 
write an exception handler are described in Chapter 4, UDI SYSTEM CALLS. 


SUMMARY 


The iRMX 86 Operating System is a flexible operating system that is used 
for many types of systems. This chapter has discussed only those 
features that directly relate to using the Configured IRMX 86 Operating 
System for program development. For more complete discussions of iRMX 86 
Operating System features, refer to the INTRODUCTION TO THE iRMX 86 
OPERATING SYSTEM. 



CHAPTER 2. USING THE SYSTEM 


You communicate with the IRMX 86 Operating System by using commands 
entered at a terminal keyboard (Figure 2-1) ; the Operating System 
communicates with you by displaying messages on the terminal screen. 

This chapter describes the process of using the Operating System, showing 
some examples of IRMX 86 commands and system responses. Chapter 3 
describes all of the commands that Intel provides with the IRMX 86 PC 
Operating System. 



Figure 2-1. Using The iRMX" 86 Operating System From A Terminal 
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The chapter la ©rgani^ed as follws: 

• STAITIIG THE SYSTEM # A section shewing how to start (bootstrap 
loaii> the system. 

• INYOillNG IR^ 86 COMMANDS. General information Including 
definition of terms used to describe individual commands. 

• EXAMPLE COMMANDS. A section showing examples of IRMX 86 
commands^ most of which manipulate files. 


STARTING THE SYSTEM 


Once you have prepared your iAPX 86,88-based hardware, as described in 
Chapter 5, you can bootstrap load ("boot”) the Operating System. 

Bootstrap loading is the process of reading the IRMX 86 Operating System 
in from a disk and giving it control of the processor. Here is how to 
boot the system. 

1. Turn on power to the disk drive, processor, and terminal. 

2 Insert a copy of the System Diskette into Disk Drive 0. (You 
should make a copy of the diskette that you receive from Intel, 
and use the copy rather than the original diskette. How to do so 
is explained at the end of this chapter.) 

3. When the terminal shows a series of (asterisk) characters, 
respond by typing an upper-case ”U". (The system continues 
sending asterisks to the screen until you type a ”U. ” The ”U” is 
not echoed on the screen.) 

4. The terminal shows a message identifying the Monitor, followed on 
the next line by a prompt of (period): 

iAPX 86, 88 Monitor, VI. 0 


5. You respond by typing the single character ”B” (upper- or 
lower-case) followed by a carriage return (CR). 

6. Now the Bootstrap Loader reads the Operating System into memory 
from your diskette, and passes control to it. (This takes about 
one-half minute. ) 

7. The Operating System displays a message identifying itself, 
followed on the next line by a prompt of (hyphen): 

IRMX 86 PC VI. 0: user = WORLD 


At this point the system is loaded and you can enter any iRMX 86 command. 
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If your system has a button connected to the RESET line on the iSBG 86 
board, you can use it to re-boot: after hitting RESET the system will 
begin displaying astericks (*) on the screen, and you continue from step 
3 above. 

The command DEBUG can be used to get to the Monitor, and from the Monitor 
you can also re-boot the system. See the descrption of DEBUG in Chapter 
3, and the Monitor commands described in Appendix C. 


CAUTION 

To prevent destroying data on your 
diskettes while re-booting, wait at 
least 2 seconds before you RESET the 
computer. 


INVOKING IRMX 86 COMMANDS 

This section describes procedures and defines terms that apply to iRMX 86 
commands. Examples of actual commands are shown in the next section, and 
additional information about individual commands is in Chapter 3. 

When you enter a command at the console keyboard, the Operating System 
loads the associated program file and executes the program. After the 
command has been executed, the Operating System displays a status message 
that confirms the effect of the command. 

The Operating System displays error messages if you attempt an invalid 
operation (e.g., trying to access a file that doesn’t exist) or if some 
error is encountered while the command is being executed (such as a 
hardware failure). These error messages are defined as part of 
Individual command descriptions in Chapter 3. 
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An example command is: 

-COPY first, second TO third, fourth QUERY 

A carriage return terminates each command, and a LINE-FEED key has the 
same effect. From here on we will assume a carriage return is the 
terminator. The general structure of a command is shown next. 

command-name inpath-list preposition outpath-list parameters 
where: 

command-name Name of the program file to be executed. After the 
command is entered, the Operating System loads the 
program file into memory from the diskette and 
executes the command. In the example, the command 
name is: 

COPY 

inpath-list One or more pathnames of files to be used as input 
during command execution. Multiple pathnames in an 
input file list must be separated by commas . You can 
type spaces (blanks) between pathnames. In the 
example, the inpath-list is: 

first, second 

preposition A word that tells the executing command how you want 
the output handled. The four prepositions used in 
iRMX 86 commands are TO, OVER, AFTER, and AS. In the 
example the preposition is: 

TO 

outpath-list One or more pathnames for the files that receive the 
output or are changed in some way. As with the 
inpath-list, multiple files names must be separated by 
commas, and embedded spaces are optional. In the 
example, the outpath-list is: 

second, third 

parameters Most commands have have a default form, but also offer 
one or more optional ways that the system can execute 
the command. You specify options with one or more 
parameters at the end of a command. Individual 
descriptions of commands in Chapter 3 define the 
effect of parameters. In the previous example, the 
parameter is: 
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You can also continue a command beyond one line, and you can add comments 
at the end of a command: 

If you need to type a command that is so long it 
cannot be typed on one line, you can continue it by 
typing an ampersand (&) character and carriage 
return. The system prompts with two asterisks (**) on 
the next line, and you can then continue the command. 

You can continue the command for as many lines as are 
necessary. A carriage return key without an ampersand 
ends the command line. A command line can have a up 
to 255 characters. Including punctuation, embedded 
blanks, continuation mark, comments, and carriage 
return. 

comment A semicolon (;) character causes the system to ignore 

anything typed between the semicolon and the 
succeeding carriage return. You can also type 
comments between a continuation mark (&) and the 
carriage return. A common use of comments is in 
SUBMIT files (see the SUBMIT command in Chapter 3). 

You can type all elements of a command in uppercase characters, lowercase 
characters, or a mix of both. For example, you can create a new file 
with the pathname **MY/TEST” and then specify the file as ”my/test” in 
subsequent file accesses. 


continuation 

mark 


PREPOSITION PARAMETERS 

Most file management commands recognize three prepositions: TO, OVER, and 
AFTER. (The preposition AS is used in the ATTACHDEVICE command and is 
explained with that command in Chapter 3. ) The prepositions have the 
following meaning: 

TO Causes the command to send the output to new files; 

that is, to files that do not already exist in the 
specified directory. If the output file does exist, 
the command will display the following message on the 
console screen: 

pathname , already exists, DELETE? 

In general, you can reply ”Y” (for yes) if you accept 
destroying the output file contents. Usually any 
other character means "no”, but there are some 
exceptions to this. Check individual command 
descriptions in Chapter 3. 
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0¥EE Causes the command to replace the contents of files 

specified in the outpath-list with the contents of the 
input files, destroying the contents of the output 
files. For example: 

-COPY sampl,samp2 OVER outl,out2 

copies the data from file sampl over the present 
contents of file outl, and copies the data of samp2 
over the contents of file out2. If either outl or 
out2 did not exist, the file would be created. 

Neither input file changes. 

AFTER Causes a command to append the contents of one or more 

files to the end of new or existing files. For 
example : 

-COPY inl,ln2 AFTER destl,dest2 

causes the contents of file ini to be written to the 
end of the contents of destl, and the contents of in2 
to be added to the end of dest2. (Neither ini or in2 
change in any way . ) 


TERMINAL CONTROLS 

Certain keys at the terminal have special effects on the Operating 
System. These are listed and described here. 

NOTE 

In this manual, CONTROL key functions 
are designated as follows: 

CTRL/character 

where CTRL specifies the CONTROL key, 
and character is an alphabetic 
character key. Depress the CTRL key 
while striking the letter key. 


CTRL/c Tells the IRMX 86 Operating System to abort the currently 

executing program. 

CTRL/o Suppresses terminal output, or restores output to normal 

mode if output is already suppressed. Typically this is 
used to ignore ("throw away”) data being sent to a 
terminal. 
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CTRL/s 

CTRL/q 


CTRL/r 


CTRL/x 


CTRL/z 


RUBOUT 


Suspends and resumes output to the terminal. Unlike 
using CTRL/o, output is not ignored; the system stops 
sending output to the terminal until you press CTRL/q* 
When you press CTRL/q, you see the remaining output. 

Repeats the current line so that you can modify it before 
the command is executed. If the line is empty, the 
system echoes the previous command so that you can 
re-execute it. 

This is used to delete a currently displayed command line 
and allows you to start the command again. The Operating 
System will echo a pound sign (#) at the point where you 
strike CTRL/x, and then move the screen cursor to the 
beginning of the next line. 

This an End-of-File character for the Console Input 
device; if you use it, it should be entered as the first 
character in a new line. 

Permits simple editing on the current line. Each time 
the RUBOUT key is pressed, the last displayed character 
is deleted with the cursor moving backward one space. 

You continue pressing the RUBOUT key until you reach the 
character to be corrected. 


In Chapter 4, the description of DQ$SPECIAL includes a definition of 
“transparent mode” input from the :CI: device, in which characters 
described here do not have their normal effect. 


UNEQUAL NUMBER OF FILES IN INPUT AND OUTPUT LISTS 

Several iRMX 86 commands require that you specify a preposition parameter 
in the command. That is, you must enter a TO, OVER, or AFTER preposition 
as one of the command parameters. Usually you specify a one-for-one match 
between the number of input files and number of output files. (This is a 
requirement for the command RENAME. ) But the following sections explain 
what happens when the number of files specified in the inpath-list does not 
equal the number of files in the outpath-list. 


More Input Files Than Output Files 

In a command (other than RENAME), if you specify more pathnames in the 
inpath-list than in the out path-list, the remaining input files are 
automatically appended to the end of the last specified output file, 
regardless of the preposition you specified. For instance, assume that in 
a COPY command you specify the following file names in the input and output 
parameters: 

COPY a,b,c TO d,e 
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When the Operating System executes the command, file "a” is copied to file 
"d", file "b" is copied to "e”, and file ”c" Is appended to the end of file 
”e" as follows: 

a TO d 
b TO e 
c AFTER e 


More Output Files than Input Files 

If you specify more file names in the outpath-llst than In the inpath-llst, 
the excess output file names are Ignored, again regardless of the 
preposition you specify. For example, assume that in a command you specify 
the following file names in the Input and output parameters: 

COPY a, b TO d,e,f,g 

When the command Is executed, file "a" is be matched with file "d", file 
”b” copied to file "e", and files "f“ and "g” are ignored, as follows: 

a TO d 
b TO e 


Safeguards 

A mismatch between the number of input files and output files is probably 
accidental. The IRMX 86 Operating System attempts to execute commands 
without destroying the Integrity of your files. When the Operating System 
encounters a command that is subject to ambiguous Interpretation or could 
result in the accidental destruction of an existing file, the command 
displays a message and prompts you to confirm or cancel the operation. 


EXAMPLE COMMANDS 


This section shows some examples of IRMX 86 commands. These examples are 
deliberately few and simple. The examples demonstrate some representative 
commands so that you can see how to Invoke a command and how to specify 
command parameters. Once you are familiar with the process of Invoking 
commands with some typical pathnames and parameters, refer to the complete 
descriptions of commands in Chapter 3 (many of which also Include examples). 


HOW TO SET THE SYSTEM DATE AND TIME 

Two of the easiest commands to use are DATE and TIME. They are shown first 
because It Is good practice to set the system date and time Immediately 
after the system has been bootstrap loaded. Figure 2-2 shows how to use 
both commands. 
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In Figure 2-2, you see the message displayed after the Operating System has 
been booted, followed by a hyphen prompt (-). This is exactly where we 
left the system in the first section of this chapter, STARTING THE SYSTEM. 
The DATE command typed in response to the first prompt displays an 
arbitrary date that indicates it has not been set since the system was 
booted. 


NOTE 

In examples of terminal dialogue^ 
commands that you type are shown in 
THIS TYPEFACE. 

Messages displayed by the system are 
shown in THIS TYPEFACE. 

The first examples show a full screen, 
but later illustrations show only the 
lower portion of the screen. 
Illustrations are not proportional to 
an actual video screen. 



iRMX 86 PC VI. 0 : user = WORLD 

-DATE 

DATE: 1 JAN 78 

-DATE 14 FEB 82 

DATE: 14 FEB 82 

-DATE 

-DATE: 14 FEB 82 

-TIME 

TIME: 00:00:00 

-TIME 9:12:05 

TIME: 09:12:05 

-TIME 

TIME 09:12:11 


kj j 



Figure 2-2. DATE And TIME Commands 
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The fourth line in the Figure 2-2 shows the date being set to Valentines 
Day of 1982. The system then responds by verifying the new date. The 
next line illustrates that any time DATE is typed without specifying a 
date, the current date is displayed. 

The next lines show the same sequence for the TIME command. The system 
first responds by displaying the system time as 

00:00:00 

Next the time is set to 12 minutes and 5 seconds after 9 AM, and the 
system verifies it on the next line. Finally, the TIME command re-typed 
shows the updated time. 

If you don’t set the system time or date, the iRMX 86 Operating System 
will not maintain the system clock. Two results of this are: 

1. Whenever you interogate the system to determine the time-of-day 
— whether by commands as shown here, or with a programmed system 
call as shown in Chapter 4 — the time will remain fixed at 
zero-hour : zero-minute: zero-second. 

2. When you display the contents of a directory, the line showing 
the date and time will not be shown. (Displaying directories is 
the subject of the next few examples.) 


HOW TO DISPLAY THE CONTENTS OF A DIRECTORY 

Frequently you need to see what files — and other directories — are 
catalogued in a particular directory. This is the function of the DIR 
command, and a few examples are shown here. 


Using the DIR Command with no Parameters 

Figure 2-3 shows the effect of typing the DIR command with no pathname or 
parameters. The system displays: 

o The current date and time, followed on the next line by 

o A message Identifying the directory, followed on the next line by 

o the name of each file and directory. 
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Figure 2-3. DIR, Default Format 


NOTE 

These examples of the DIR command 
assume that you are using an exact copy 
of the iRMX 86 PC System Diskette, that 
it is in Drive 0, and that no files or 
directories have been added or 
deleted. (Figure 1-5 shows the 
contents of this diskette. ) 


If you do not specify any other parameters in a DIR command, only the 
names of the directory entries are displayed. In the example in Figure 
2-3, you cannot tell the size of each entry, or whether it is a directory 
or a file. By specifying an optional display format with a DIR command, 
you can see these and other characteristics of the directory entries. 

DIR offers you a variety of display options, one of which is shown in the 
next example. 

The VOLUME number 144446 is the name by which the system knows the 
particular diskette on which the directory is located. This name or 
number may vary; it is established when a disk is initialized (see the 
FORMAT command in Chapter 3). 
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If you do not specify a device, the system will assume that you are using 
Disk Drive 0 (zero). This is known as the default system device . Tlie 
uppermost (root) directory on Drive 0 is the default directory ($); this 
is true regardless of what diskette you have in that drive. If a file or 
directory is on drive 0, you do not usually have to specify the drive (an 
exception is shown later). If a file or directory is in the default 
directory you don^t have to specify a directory name. 


Directory Displayed in an Alternate Format 


Figure 2-3 again shows the contents of the default directory, but with 
the parameters SHORT and ONE. With optional parameters, you can control 
the physical format (ONE specifies that only one entry be on a line) and 
the type of information displayed (SHORT displays more infomation than in 
the previous example). 


-DIR :AFD0: SHORT ONE 

14 FEB 82 08:04:52 


DIRECTORY 

OF :AFD0: 

ON VOLUME 144446 


NAME 

AT 

ACC 

BLKS LENGTH 


SYSTEM 

DR 

DLAC 

2 304 


PROG 

DR 

DLAC 

0 0 


WORK 

DR 

DLAC 

0 0 



3 FILES 


2 BLKS 

304 BYTES 



Figure 2-4. SHORT, ONE-Column Directory Display 

Figure 2-4 shows, in addition to the names of each entry: 

• Whether the entry is a file or directory (AT column, where DR 
means directory) 

• The access rights (ACC coltunn) 

• The number of blocks and number of bytes (BLKS and LENGTH) 

• A summary of everything in the directory 
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One further comment about Figure 2-4; the drive (:AFDO:) is specified 
even though it is the default system device. This is because if the 
command had been typed without the drive number — DIR SHORT ONE — the 
Operating System would have looked for a directory named SHORT. You may 
wonder what happens when you type a command that the Operating System 
cannot interpret correctly. In this case, the system would not have 
found a directory with the name SHORT, and would have displayed the error 
message: 

SHORT, file does not exist 

In this case, if there had been a directory named SHORT within the 
default directory, the DIR command would have displayed its contents. 


Directory Listing of SYSTEM Directory 


Figure 2-5 shows the directory named SYSTEM, using the default listing 
format (no parameters). 


-DIR SYSTEM 

14 FEB 82 08:05:01 


DIRECTORY OF 

SYSTEM ON 

VOLUME 

144445 


CREATEDIR 

BACKUP 

COPY 

RMX86 

SUBMIT 

DISKVERIFY 

DIR 

DELETE 

RENAME 

RESTORE 

ATTACHDEVICE 

DOWNCOPY 

FORMAT 

TIME 

DATE 

DETACHOEVICE 

UPCOPY 

UDI 

DEBUG 



v: y 


Figure 2-5. Display of System Directory 
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Directory Listing of SYSTEM/UDI 

In Figure 2-5, note the entry ”UDI”. This is the directory containing 
the UDI library files. The next example. Figure 2-6, displays this 
directory in the default style (no parameters specified) and then in a 
SHORT, ONE-column style. 


-miR system/udi 

14 FEB 82 08:09:12 

DIRECTORY OF system/udi ON 
UOI.EXT URXCOM.LIB 


VOLUME 144446 
URXSML.LIB URXLRG.LIB 


-DIR system/udi SHORT ONE 

14 FEB 82 08:09:32 

DIRECTORY OF system/udi 


ON VOLUME 144446 


NAME AT 

ACC 

BLKS 

LENGTH 

UDI. EXT 

DRAU 

14 

3426 

URXCOM.LIB 

ORAU 

140 

35682 

URXSML.LIB 

DRAU 

142 

36118 

URXLRG.LIB 

DRAU 

141 

35888 

4 FILES 

437 

BLKS 

ii: 


111114 BYTES 


Figure 2-6. SYSTEM/UDI Directory 


Note that each entry is a file, as Indicated by the blank entry under AT. 
Also, the name of the directory was typed in lower case; the effect was 
the same as if it had been typed in upper case. 


HOW TO COPY FILES 

The next few examples show how the COPY command is used to duplicate 
files. For these examples, assume that a file named FIRST exists on 
diskette :AFD0: in the default directory. 
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Creating a New Copy of a File 

Figure 2-7 shows how to create a single copy of a file in the same 
directory. 



Figure 2-7. Copying a File Into the Same Directory 


Copying Multiple Files With One Command 

It is possible to copy more than one file with a single copy command. 
Figure 2-8 shows how to create copies of the files FIRST and SECOND. 



Figure 2-8. Copying Multiple Files With One Command 
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Copying One File OVER Another 

You can copy the contents of one file into another. The preposition OVER 
tells the system to destroy the current contents of the file specified in 
the outpath-llst and copy the contents of the file specified in the 
Inpath-llst into the file. This is shown in Figure 2-9. 



Figure 2-9. Copying One File OVER Another 


Using the OVER preposition explicitly deletes the contents of a file. 
Using the preposition TO can have the same effect, but with one 
difference. If you use the TO preposition to copy a file into a file 
that already exists, the system displays a message asking if you actually 
want to destroy the contents of the existing file (as shown in Figure 
2 - 10 ). 



Figure 2-10. Copying a File TO an Existing File 
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In the example in Figure 2-10, the reply to the query "DELETE?" is "N", 
which tells the system not to destroy the file. The operation was 
cancelled. If the reply to "DELETE?” had been "Y”, the contents of 
SECOND would have been destroyed and the contents of FIRST copied into 
the new file SECOND. 


CREATING A DIRECTORY 

The CREATEDIR creates new directories. For example, you can create a 
directory within your default directory ($) and then copy files into that 
directory. This is shown in Figure 2-11. 


1 


-CREATEDIR NEW 

NEW, directory created 

- COPY FIRST TO NEW/FIRST 

FIRST CO pi ed TO NEW/FIRST 



Figure 2-11. Creating A New Directory 


DISPLAYING THE CONTENTS OF A FILE AT THE TERMINAL 

You can view the contents of a file at the console terminal (:C0:) using 
the COPY command. The file should contain string data (like the output 
of an editor) rather than binary data (like the object file from a 
compiler). Displaying a binary file will produce a meaningless display, 
although it will not affect the file. 

The Operating System assumes "TO :C0;" if you do not specify either a 
preposition or outpath-list with a COPY command. Figure 2-12 shows the 
command to display the contents of the file SECOND. 
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-COPY SECOND 

This string is in an example file 
that illustrates the use of 
iRMX 86 Commands, 

The file contains four lines including this one. 
SECOND copied TO :C0: 


V J 



Figure 2-12. Displaying Contents of a File on a Terminal 


GIVING A FILE A NEW NAME 

The Operating System provides the RENAME command to rename a file. You 
can use the COPY and DELETE commands to accomplish the same thing. 
However, the COPY command actually moves the contents of the file being 
copied and leaves the original file intact. The RENAME command leaves 
the file Intact, but changes the pathname. Figure 2-13 shows the RENAME 
command used to rename THIRD. 


-RENAME THIRD TO FIFTH 

THIRD renamed TO FIFTH 





Figure 2-13. Renaming a File 

Both flies and directories can be renamed. If a directory Is renamed, 
any flies or directories cataloged under that directory will 
automatically have new pathnames. You should note this If programs you 
have written use flies In the directory. 

The OVER preposition Is valid In a RENAME command, and Its effect Is 
explained In Chapter 3. 
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HOW TO MAKE COPIES OF YOUR SYSTEM DISKETTE 

You should make a copy of the System Diskette that you received with the 
iRMX 86 PC package* Listed below are the steps necessary to do so* We 
assume that you have only two disk drives on you system, and that you 
have read about the BACKUP, RESTORE, and FORMAT commands in Chapter 3. 

To make a new Sytem Diskette: 

1* Format two new diskettes, one as a PHYSICAL volume, and one as a 
NAMED volume* (BACKUP writes to a PHYSICAL-formatted diskette, 
and RESTORE copies from this diskette to a NAMED volume* ) Both 
diskettes can be formatted in Drive 1. 

2. Using BACKUP, write the System Diskette contents onto the 
diskette that you formatted as a PHYSICAL volume* One of the 
parameters to BACKUP is pathname ; you should specify only the 
volxime (:AFDO:). 

3. Run RESTORE* When the RESTORE program prompts for the volume to 
be mounted, remove the system diskette from Drive 0, insert the 
volume that you formatted as a NAMED volume into Drive 0, and 
type Y* When invoking RESTORE, again specify :AFD0: as the 
pathname* 

4. When RESTORE completes, you should be able to re-boot from the 
new diskette* Save both the diskette you received from Intel and 
the diskette which BACKUP wrote* 


NOTE 

When formatting your diskette, specify 
an interleave factor of seven (7) 
rather than the FORMAT command default 
value of five (5)* The reason is that 
an interleave factor of five will 
result in a much slower boostrap 
process: nearly two minutes rather than 
about one-half minute. 
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CHAPTER 3. iRMX” 86 COMMANDS 


The commands described in this chapter are supplied by Intel. You can 
use the commands to perform a number of highly convenient file management 
functions. When you invoke a command, 

1. You type the command name and parameters (e.g. , "COPY FIRST TO 
SECOND"). 

2. The the Operating System loads the the appropriate command file 
(for example, SYSTEM/COPY) and executes the program. 

3. The program executes the command the way that you specify in the 
command line. 

These commands are part of the iRMX 86 Huunan Interface (one layer in the 
Operating System), so the Human Interface is mentioned occasionally in 
descriptions of Individual commands. The commands exist as program files 
in the SYSTEM directory. When you type a command on the terminal, the 
Operating System looks for the file having that name in the default 
directory ($), then in the PROG directory, then in the SYSTEM directory. 

These commands are presented in alphabetical sequence without regard for 
functional organization. A functional grouping of the commands is given 
in the Human Interface Command Dictionary in Table 3-1 for fast reference. 


COMMAND SYNTAX SCHEMATICS 


The syntax for each command described in this chapter is presented by 
means of a "railroad track” schematic, with syntactic elements scattered 
along the track. Your entrance to any given schematic is always from 
left to right, beginning with some command name entry. 

Elements shown in uppercase characters must be typed in a command line 
exactly as shown in the command schematics except that you can type them 
either in uppercase or lowercase characters. Elements shown in lowercase 
characters are generic terms, which means that you supply the specific 
item, such as the pathname for a file. The example that follows shows 
the possible paths through a railroad track schematic. Notice that the 
main track goes through required elements in a given command. 

"Railroad sidings" go through optional parameter elements. In some 
cases, you have a choice of going through one of several possible sidings 
before returning to the main track. If the main track itself divides 
into two separate tracks, you select one parameter or the other but not 
both. 
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(START) 



In this example: 

• A Is a required element. 

• Either B or C is required but not both. 

• D, E, or F are all optional but only one can be selected. 

• G is required. 


You can abbreviate command parameters Instead of typing the entire 
parameter. To abbreviate a parameter, type as many characters as are 
required to make the parameter name unique. For example, the 
ATTACHDEVICE command has two parameters, NAMED, and PHYSICAL; you can 
abbreviate NAMED to N and PHYSICAL to P. 

You cannot abbreviate either the command name or the prepositions (TO, 
OVER, AFTER, AS). 
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Table 3-1. iRMX- 86 Command Dictionary 


Command 

Synopsis 

Page 

File and Volume Management Commands 

ATTACHDEVICE 

Attaches a new physical device to the system 
and adds its logical name to the root job’s 
object directory. 

3-5 

BACKUP 

Copies named files to a backup volume. 

3-8 

COPY 

Creates new data files, or copies files to other 
pathnames. 

3-15 

CREATEDIR 

Creates one or more new directories. 

3-18 

DELETE 

Deletes data files and empty directories from a 
volume on secondary storage. 

3-22 

DETACHDEVICE 

Removes a physical device from system use and 
deletes its logical name from the root job's 
object directory. 

3-24 

DIR 

Lists a directory's filenames (and optionally, 
file attributes). 

3-25 

DISKVERIFY 

Verifies the data structures of named and 
physical voltimes. 

1 

3-32 

DOWNCOPY 

Copies files and directories from an iRMK 86 
volume mounted on a secondary storage device to 
an ISIS~II secondary storage device. 

3-37 

FORMAT 

Formats an iRMX 86 volume. 

3-40 

RENAME 

Renames files or directories. 

3-45 

RESTORE 

Copies files from a backup volume to a named 
volxme. 

3-48 

UPCOPY 

Copies files and directories from an ISIS-II 
secondary storage device to an iRMX 86 volume 
mounted on a secondary storage device. 

3-59 
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Table 3-1. IRMX" 86 Command Dictionary (continued) 


Command 

Synopsis 

Page 

General Utility Commands 

DATE 

Sets or resets the system date, or displays the 
current date. 

3-20 

DEBUG 

Transfers control to the iSBC 957A/B package to 
debug an iRMX 86 application program. 

3-21 

SUBMIT 

Reads, loads, and executes a string of commands 
from secondary storage instead of the keyboard. 

3-55 

TIME 

Sets or resets the system clock, or displays the 
current system time. 

3-58 
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iRMX” 86 COMMANDS 


ATTACHDEVICE 


This command makes a physical device known to the system by a logical 
name* After the device Is attached^ It Is accessed by commands and system 
calls with the logical name you specify* 

The format of the command Is as follows: 



INPUT PARAMETERS 

physical Physical name of the device to be attached to the 

name system. These physical names were defined for 

your Operating System when the system was 
configured* 

AS Preposition; required for the command 

: logical name: This is the name that you assign to the device; it 

must be delimited with colons (:), and can be a 
maximum of 12 characters long including colons* 
After the device is attached with the ATTACHDEVICE 
command, any command or program code that accesses 
the device must specify the logical name* 

NAMED Specifies that the volume mounted on the device is 

already formatted for NAMED files* Examples of 
named-file volumes are diskettes or hard disk 
platters* If neither NAMED nor PHYSICAL are 
specified, NAMED is the default* See the FORMAT 
command in this chapter for a further description 
of NAMED files* 

PHYSICAL Specifies that the volume mounted on the logical 

device is already formatted as a single, large 
file* An example is a line printer* See the 
FORMAT command in this chapter for a further 
description of PHYSICAL volumes. 


3-5 


ATTACHDEVICE 


iRMX* 86 COMMANDS 


DESCRIPTION 

A physical device must be attached to the system before it can be 
accessed; the device will be know by the logical name you assign* When 
you boot your iRMX 86 PC Operating System, the Operating System 
automatically attaches certain devices. These devices and logical names 
are listed in Chapter 1* 

The most frequent use of the ATTACHDEVICE command is to attach a new 
device, such as a new disk drive or a line printer. For example, if you 
add a third disk drive to your system, you could attach it with the 
command 

ATTACHDEVICE AFD2 AS :AFD2: 

The logical name :AFD1: could just as well be :DISK3:, or any other name 
you wish to assign. The physical name AFD2 must be a name the Operating 
System has defined. The physical names for iRMX 86 PC disk drives are 
listed in a table in Chapter 5, PREPARING YOUR HARDWARE. The iRMX 86 PC 
Operating System has already assigned when the system is booted are 
listed in Chapter 1. (See the DETACHDEVICE command in this chapter for a 
description of how to detach a device from the system. ) 

When the attachment is completed, the ATTACHDEVICE command displays the 
following message: 

physical name, attached as logical name 

where "physical name” and "logical name” will be as specified in the 
ATTACHDEVICE command. 


ERROR MESSAGES 

logical name, device already attached 

The specified physical device is already attached. ATTACHDEVICE does not 
attach the device. 

device name, device does not exist 

The physical device you specified is not a name the Operating System 
recognizes. ATTACHDEVICE does not attach the device. 


logical name, invalid logical name 

The logical name specification is not enclosed with colons, contains 
unmatched colons, is longer than 12 characters, or contains Invalid 
characters. ATTACHDEVICE does not attach the device. 


3-6 



ATTACHDEVICE 


iRMX~ 86 COMMANDS 


logical name, logical name already exists 

The specified logical name is already used to attach a device. 
ATTACHDEVICE does not attach the device. 


physical device, may not be attached as a (NAMED or PHYSICAL) 

The NAMED or PHYSICAL specification in the command is not allowed for 
that physical device; for example, defining a line printer as a NAMED 
volume. ATTACHDEVICE does not attach the device. 


008A : E$CONTROL, too many device names 

You tried to attach more than one physical device with a single 
ATTACHDEVICE command. ATTACHDEVICE does not attach a device. 


logical name, volume is not a named volume 

ATTACHDEVICE attempted to attach a device as a named device and 
discovered a physical volume on the device. However, ATTACHDEVICE does 
attach the device. 


logical name, volume not formatted 

ATTACHDEVICE attempted to attach a device as a named device and 
encountered an I/O error while searching for the volume’s root 
directory. However, ATTACHDEVICE does attach the device. 


logical name, volume not mounted 

The specified device does not contain a volume; i.e. , the diskette is not 
in the drive. However, ATTACHDEVICE does attach the device. 


logical name, exception code 

ATTACHDEVICE was unable to attach the specified device. This message 
lists the IRMX 86 exception code encountered. IRMX 86 exception codes 
are listed in Appendix A. 
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BACKUP 


This command saves files in a named volume by copying them to a physical 
volume which serves as a backup volume. Later, you can use the RESTORE 
command (described later in this chapter) to retrieve these files and 
copy them to named volumes. 

The format of this command is as follows: 



INPUT PARAMETERS 

pathname Pathname of a file on the source volume. BACKUP 

saves files from the branch of the file tree that 
begins with the specified file. If you specify 
the logical name of the device only, BACKUP saves 
files beginning with the root directory of the 
volume. 

*dd mmm yy* Date parameter that BACKUP uses, in conjunction 

with the time parameter, to determine which files 
to save. BACKUP saves only those files that have 
been modified since the specified date and time. 
You must enclose the date parameter in single 
quotes. The individual fields of this parameter 
are: 

dd Two-digit number that specifies the day of 
the month. 

mmm Three-character abbreviation for the 
month, as follows: 


JAN 

APR 

JUL 

OCT 

FEB 

MAY 

AUG 

NOV 

MAR 

JUN 

SEP 

DEC 


yy Two-digit number that specifies the year. 

If you omit this parameter but specify the time 
parameter, the date defaults to the current 
system date. If you omit both the date and time 
parameters, the date defaults to 1 JAN 78. 


BACKUP 


INPUT PARAMETERS (continued) 

hh:mm: ss Time parameter that BACKUP uses, in conjunction 

with the date parameter, to determine which files 
to save* BACKUP saves only those files that have 
been modified since the specified date and time* 
The individual fields of this parameter are: 

hh Hours specified as 0-24* 

mm Minutes specified as 0-59. 

ss Seconds specified as 0-59* 

If you omit this parameter, the time defaults to 

00 : 00 : 00 . 

QUERY Causes the Human Interface to prompt for 

permission to save each file* The Human Interface 
prompts with one of the following queries: 

pathname, BACKUP data file? 

or 

pathname, BACKUP directory? 

Enter one of the following responses to the query : 


Entry 

Action 

Y or y 

Save the file. 

E or e 

Exit from the BACKUP command. 

R or r 

Continue saving files without 
further query. 

Any other 
character 

If data file, do not save the 
file; if directory file, do not 
save the directory or any file in 
that portion of the directory 


tree* Query for the next file, if 
any* 


OUTPUT PARAMETER 

: backup device: Logical name of the device to which BACKUP copies 

the files* 


3-9 



BACKUP 


DESCRIPTION 

BACKUP is a utility which saves named files on backup volumes, such as 
diskettes. BACKUP saves the following Information for each file: 

• File name 

• Access list 

• Extension data 

• User ID of the file owner 

• File granularity 

• Contents of the file 

You can copy this information back to a named file by using the RESTORE 
utility, described later in this chapter. 

Before a volume can be used as a backup volume, the volume must be 
formatted. Although BACKUP will accept both physical and named volumes, 
it is recommended that you supply freshly-f ormatted physical volumes or 
old backup volumes for this purpose. BACKUP issues a message before 
continuing if the backup volume you supply is anything other than a 
freshly-formatted physical volume. When BACKUP copies files to the 
backup volume, it overwrites any information that currently exists on the 
VO lume . 

In order for BACKUP save files from a named volume, you must have read 
access to the files and to the directories that contain them. 

You can limit the files which BACKUP processes in the following ways: 

• If you specify a complete directory name instead of just the 
device’s logical name in the invocation line, BACKUP limits its 
processing to the specified directory and all subdirectories. 

• If you specify the date and time parameters, BACKUP processes 
only those files modified since the specified time. 

• If you specify the QUERY parameter, BACKUP asks permission before 
saving each file. If you deny permission for BACKUP to save a 
data file, BACKUP skips the file and continues with the next 
file. If you deny permission for BACKUP to save a directory 
file, BACKUP skips the directory and all files contained in the 
directory or its subdirectories. 

When you enter the BACKUP command, BACKUP displays the following sign-on 
message: 

iRMX 86 DISK BACKUP UTILITY, Vx.x 

where Vx.x is the version number of the utility. It then prompts you for 
a backup volume. 
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DESCRIPTION (continued) 

Whenever BACKUP requires a new backup volume, it displays the following 
message: 

backup device, mount backup volume #nn, enter Y to continue: 

where backup device indicates the logical name of the backup device and 
nn the number of the requested volume. (BACKUP in some cases displays 
additional information to indicate problems with the current volume.) In 
response to this message, place a volume in the backup device and enter 
one of the following: 

Entry Action 

Y, y, R or r Continue the backup process. 

E or e Exit from the BACKUP command. 

Any other Invalid entry; reprompt for entry, 

character 

BACKUP continues prompting for a backup volume until you supply one that 
it can access. 

If the backup volume you supply is not a freshly-formatted physical 
VO lume , but one that BACKUP can access (such as a named volume, a 
previously-used backup volume, or a physical volume containing data), 
BACKUP informs you of this with one of the following messages: 

backup device, not a physical volume, enter Y to overwrite: 

or 

backup device, backup volume #nn, date, enter Y to overwrite: 

where backup device is the logical name of the backup device, nn is the 
volume number of the backup volume, and date is the date on which the 
previous backup was performed. In response to these messages, enter one 
of the following: 


Entry 

Action 


Y, y, R, or r 

Use the volume as a backup volume, 
information currently stored on the 

overwriting the 
VO lume. 

E or e 

Exit from the BACKUP command. 


Any other 
character 

Reprompt for another volume. 
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DESCRIPTION (continued) 

As BACKUP saves each file in the source volume, it displays the following 
message at the Human Interface console output device (:C0:): 

pa t hname , SAVED 

If your backup volume becomes full and you supply additional backup 
volumes, you should write the numbers of the backup volumes on the volume 
labels* Later, when you later restore files to a named volume with the 
RESTORE utility, you must supply the backup volumes in order* 


ERROR MESSAGES 

backup device, backup voltime #nn, date, enter Y to overwrite: 

The backup volume you supplied already contains backup information* 

BACKUP lists the logical name of the backup device, the volume number, and 
the date on which the original backup occurred* It overwrites this volume 
if you enter Y, y, R, or r* 


backup device, cannot attach volume 
backup device, exception code 

backup device, mount ba^ckup volume #nn, enter Y to continue: 

BACKUP cannot access the backup volume. This could be because there is no 
volume in the backup device, the volume is write protected, or because of 
a hardware problem with the device* The second line of the message 
indicates the iRMX 86 exception code encountered* BACKUP continues to 
issue this message until you supply a volume that BACKUP can access • 


pathname, exception code, cannot back up file 

For some reason BACKUP could not copy a file from the named volume , 
possibly because you do not have read access to the file or because there 
is a faulty area on the named volume* The message lists the pathname of 
the file and the exception code encountered* BACKUP copies as much of the 
file as possible and continues with the next file. 


backup device, error writing volume label 
backup device, exception code 

backup device, mount backup volume #nn, enter Y to continue: 

When BACKUP attempted to write a label on the backup volume, it 
encountered an error condition, possibly because of a faulty area on the 
volume, or because the volume is not formatted* The second line of the 
message indicates the iRMX 86 exception code encountered. BACKUP 
reproBq>ts for a different backup volume. 
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ERROR MESSAGES (continued) 

pathname, file does not exist 

The pathname you specified as input to BACKUP does not represent an 
existing file or device. 

backup device, invalid backup device 

The logical name you specified for the backup device was not a logical 
name for a device. 


exception code, invalid DATE or TIME 

For either the DATE or TIME parameter, you entered a value that is out of 
range (such as 31 FEB 81 or 26:03:62). The message lists the exception 
code encountered as a result of this entry. 

backup device, invalid logical name 

The logical name you specified for the backup device contains unmatched 
colons, is longer than 12 characters, contains invalid characters , or 
does not exist. 

backup device, not a physical volume , enter Y to overwrite: 

The backup volume you supplied was formatted as a named volume or 
contained some other information. BACKUP will overwrite this volume if 
you enter Y, y, R, or r. 


output specification missing 

You did not supply the logical name of the backup device when you entered 
the BACKUP command. 


keyword, too many values 

You entered too many values with either the DATE or TIME parameters . The 
keyword portion of the message indicates the parameter that is in error. 


keyword, unrecognized control 

You entered one of the optional parameters of the form ”keyword=value, ’* 
but the keyword was not DATE, TIME, or QUERY. 
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ERROR MESSAGES (continued) 

backup device, volume not formatted 

backup device, mount backup volume #nn, enter Y to continue: 

The backup volume you supplied was not formatted* BACKUP continues to 
issue this message until you supply a formatted backup volume* 

backup device, write error on backup volume 
backup device, exception code 

BACKUP encountered an error condition when writing information to the 
backup volume* The second line of the message lists the exception code 
encountered* This error is probably the result of a faulty area on the 
volume* 


pathname, exception code 

The pathname you specified as input to BACKUP is in error* This error 
could occur if you specify the same logical name that you specified for 
the backup device. It could also occur if you specify an invalid or 
nonexistent path component* This message displays the exception code 
that results from this error* 
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COPY 

This command reads data from the specified input source or sources and 
writes the output to the specified destination file or files. 

The format of the command is as follows: 



INPUT PARAMETERS 
inpath-list 


QUERY 


One or more pathnames for the files to be copied. 
Multiple pathnames must be separated by commas. 
Separating blanks are optional. To copy files on 
a one-for-one basis, you must specify the same 
number of files in the inpath-list as in the 
outpath-list. 


Causes the Human Interface to prompt for 
permission to copy each file. Depending upon the 
specified preposition (TO, OVER, or AFTER), the 
Human Interface prompts with one of the following 
queries: 


pathname, copy TO out-pathname? 
pathname, copy OVER out-pathname? 
pathname, copy AFTER out-pathname? 


Enter one of the following (followed by a carriage 
return) in response to the query: 


Entry 
Y or y 
E or e 
R or r 

Any other 
character 


Action 

Copy the file. 

Exit from COPY command 
Continue copying files without 
further query. 

Do not copy this file; go to the 
next file in the input list. 
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OUTPUT PARAMETERS 

Writes the listed input files to named new 
output files* The specified output file dr 
files should not already exist; if they do, COPY 
will request permission to delete the existing 
files before it executes the copy operation for 
that file. If more input files than output 
files are listed, the remaining input files will 
be appended to the end of the last listed output 
file. 

Writes the listed input files over (replaces) 
the existing output files on a one-for-one 
basis, regardless of file size. If an output 
file does not already exist, its corresponding 
input file is written to a new file with the 
listed output file name. If more input files 
than output files are listed, the remaining 
input files will be appended to the end of the 
last listed output file. 

Appends the input file or files to the current 
data in the existing output file or files. If 
the output file does not already exist, all 
listed input files will be concatenated into a 
new file with the listed output file name. 

outpath-list One or more pathnames for the output files. 

Multiple pathnames must be separated by commas . 
Separating blanks are optional. If the 
preposition and output parameter defaults are 
exercised in the command line, the output will 
go to the user *s console screen (TO : CO : ) . 


DESCRIPTION 

COPY is a powerful and versatile command with a wide range of file 
handling applications (See Chapter 2 for examples) • Implementation 
depends upon your selection of a preposition and your input file and 
output file specification in the command line. The following are some 
of the COPY command’s features: 

• Create new files (TO preposition). 

• Copy over existing files or create new files (OVER preposition). 

• Add data to the end of existing files {AFTER preposition). 

• Copy a list of files to another list of files on a one-for-one 
basis. 

• Concatenate two or more files into a single output file. 


OVER 


AFTER 
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DESCRIPTION (continued) 

As each file is copied, the COPY command displays one of the following 
messages, as appropriate: 

pathname, copied TO out-pathname 

pathname, copied OVER out-pathname 

pathname, copied AFTER out-pathname 

If you do not specify a preposition or output file, TO :C0: is the 
default output. The Human Interface normally expects all listed output 
files to be new files when the TO preposition is used; however, it is 
prepared to deal with existing files. If an existing output file name 
is encountered during a copy operation using TO, the Human Interface 
displays the the following message: 

pathname, already exists, DELETE? 

Enter Y or y if you wish to delete the existing file. The COPY command 
will delete the file. 

Enter any other character if you do not wish to delete the existing 
file. The COPY command will pass over the corresponding input file 
without copying it, and will attempt to copy the next listed input file 
to its corresponding output file. 

If more input files than output files are specified, the remainder of 
the input files will be appended to the end of the last listed ouput 
file. As each file is appended, the following message is displayed on 
the console screen: 

pathname, copied AFTER out-file 

If there are fewer input filenames than output filenames specified in 
the COPY command (regardless of the preposition) , the output files 
remaining after the last valid copy operation will be ignored. 

You cannot successfully use COPY to copy a directory to a data file or 
to another directory. Although a directory can be copied, the 
attributes of the directory are lost. That is, the directory can no 
longer be used as a directory. However, a file listed under one 
directory can be copied to another directory. For example: 

copy samp /test/a to : fl : /alpha/beta 

would copy the A data file to a different volume, directory, and 
filename, where the new filers pathname would be : f 1 : /alpha/beta. 
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CREATED IR 


This command creates one or more iRMX 86 user directories. 
The format is as follows: 



INPUT PARAMETER 

inpath-list One or more pathnames of the iRMX 86 directories 

to be created. Multiple pathnames must be 
separated by commas. Embedded blanks between 
commas and pathnames are optional. 


DESCRIPTION 

A created iRMX 86 directory allows all access functions; that is, you can 
read/write, delete, list, add, and change the contents of the directory 
you created with CREATEDIR. 

The following message is displayed if a directory is successfully created 
directory-name, directory created 

You can create new directories that are subordinate to other directories. 
For example: 

createdir ab/dc/ef/GH 

would cause the newly-created directory GH to be nested within existing 
directory EF, which in turn, is nested within directory DC, and so on. 

It is suggested that you use uppercase letters when you enter a new 
directory name in a CREATEDIR command, and use lowercase letters when you 
create a new data filename in a COPY command. You can then easily 
distinguish between directory names and filenames in a directory listing. 

You can check the contents of the directory at any time by using the DIR 
command to list the directory (see the DIR command in this chapter). 


ERROR MESSAGES 

directory name, invalid file type 
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ERROR MESSAGES (continued) 

You attenpted to create a directory using a data file as part of the new 
directory’s pathname; only other directory names are allowed in the 
pathname for a new directory. 

directory-name, directory already exists 

The specified pathname of the directory to be created already exists. 
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This command sets a new system date or displays the current date. 
The format is as follows: 



INPUT PARAMETERS 


dd 


Two-digit number that specifies the day of the month. 


mmm 


Three -character abbreviation for the specified 
month, as follows: 


JAN 

APR 

JUL 

OCT 

FEB 

MAY 

AUG 

NOV 

MAR 

JUN 

SEP 

DEC 


yy 


Two-digit number that specifies the year. 


DESCRIPTION 

The dd, mmm, and yy entries are separated by single blanks • 

If no new date is specified in the DATE command, the current date is 
displayed. 

If one of the date entries in the parameter string is set, all three must 
be; there are no default settings for individual entries within the 
parameter string. 

If you request the system date on a non-t iming system, the following 
message will be displayed: 

00 : 00:00 

See also the TIME command in this chapter if you wish to set the system 
clock in conjunction with setting the date. 


ERROR MESSAGES 

Errors in a date entry, such as syntax errors or a number out of range 
(i.e., 31 FEB 81), cause the following error message to be displayed: 

illegal date 

If this occurs , reenter the DATE command with the correct syntax. 
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DEBUG 


This command allows you to debug your iRMX 86 application jobs if your 
system is configured with the iSBC 957A/B package. 



INPUT PARAMETERS 

command pathname Pathname of the file containing the application 

program to be debugged. 

parameter string String of required, optional, and default 

parameters that can be used in the command line to 
load and execute the application program. 


DESCRIPTION 

DEBUG loads your specified application program into main memory and 
transfers control to the iSBC 957A/B package. You can then use the iSBG 
957A/B package to single-step, display registers, and set breakpoints 
within the program. Refer to the appropriate iSBC 957A or iSBC 957B 
user’s guide for a complete description of the iSBC 957A/B functions. 

When DEBUG executes, the 957A/B package runs with its interrupts 
disabled. Therefore, the time-keeping function is also disabled, with 
the following consequences: 

• Impacts the ability of the Nucleus to execute time-out tasks that 
have provided time limits to system calls, such as RECEIVE$UNITS 
and RECEIVE$ MESSAGE. 

• Impacts the ability of the Basic I/O System to keep track of the 
time-of-day and write its data structures to secondary storage. 

The 957A/B package cannot tolerate interrupts while the single-stepping 
command is being used. Single -stepping will be affected if: 

• Tasks are using non-zero time-out values in system calls such as 
RECEIVE$UNITS and RECEIVE$MESSAGE. 

• Time-of-day is configured in the Basic I/O System. 

• Non-zero update timeout values are specified in the Basic I/O 
System’s Device Unit Information Blocks (DUIB). 

The alternative to single-stepping is to use breakpoints. 
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DELETE 


This command removes data files and empty directories from secondary 
storage* 

The format is as follows: 



INPUT PARAMETERS 

inpath-list One or more pathnames for the files or empty 

directories to be deleted. Multiple pathname 
entries must be separated by commas* Separating 
blanks are optional. 

QUERY Causes the DELETE command to ask for your 

permission to delete each file in the list. Prior 
to deleting a file, the DELETE command displays 
the following query: 

pa t hname , DELETE ? 

Enter one of the following, followed by a carraige 
return, in response to the query: 


Entry 

Action 

Y or y 

Delete the file. 

E or e 

Exit from DELETE command. 

R or r 

Continue deleting without further 
query. 

Any other 
character 

Do not delete file; 

query for next file in sequence. 


DESCRIPTION 

The DELETE command allows you to release unused secondary storage space 
for new uses by removing empty directories and unneeded data files. If a 
file to be deleted is currently attached, it will be marked for deletion 
and deleted when the file is detached. 

The following message is displayed as each file is deleted or marked for 
deletion: 

pathname, deleted 
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ERROR MESSAGES 

pathname, DELETE access required 
You do not have permission to delete a specified file* 
pathname, does not exist 

The specified file was not found (e.g*, a syntax error in a pathname or 
the file is located in some other directory). The DELETE command will 
attenpt to delete each succeeding file specified in the filename-list 
after it has encountered an error in a file name- 

pathname, directory not empty 

Non-en5>ty directories may not be deleted. You attempted to delete a 
directory that still lists filenames or other directory names. 

If you still wish to delete the directory, you must first delete all its 
contents. For example, if you wished to delete a directory named ALPHA 
that contained a data file with the pathname ALPHA/B ETA/ SAMP, you would 
enter the following command: 

delete alpha/beta/samp , alpha/beta, alpha 

which would delete all files cataloged in ALPHA before the directory 
itself was deleted. 
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This command detaches the specified logical device* 




ETACHDEVICE> 


INPUT PARAMETER 

: logical name: Logical name of the physical device that is to be 

deleted from the root job’s object directory. 


DESCRIPTION 

The DETACHDEVICE command allows you to detach a device without having to 
reconfigure the system. After a device is detached, no volume mounted on 
that device is accessible for system use. For a description of formatted 
volumes (NAMED or PHYSICAL), see the FORMAT command description in this 
chapter. 

When the device is detached and its logical name has been deleted from 
the root job’s object directory, the DETACHDEVICE command will display 
the following message: 

logical-name, detached 


NOTE 

Using the DETACHDEVICE command to 
detach the device containing your Human 
Interface commands causes loss of 
access to Human Interface functions 
until the system is restarted. 


ERROR MESSAGE 

illegal logical name 

Either there is a syntax error in the logical name specification or the 
logical name does not exist in the root job’s object directory. 
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DIR 

This command lists the names and attributes of files contained in a given 
directory, including data filenames and directory names. 

The format of the command is as follows: 



INPUT PARAMETERS 
inpath--list 


EXTENDED 


LONG 


One or more pathnames of the directories to be 
listed. Multiple directory pathname entries must 
be separated by commas. Separating blanks are 
optional. If no pathname is specified, the user’s 
default directory is listed. 

Lists all available information for each data file 
or directory file in the directory. The first 
line for each file will be the same as for the 
LONG form. The second line will contain the last 
access date, creation date, and the accessor 
list. The listing will be in a double-column 
format (see Figure 3-1 at the end of this command 
description). 

Lists file information in a one-line format (see 
Figure 3-2 at the end of this command description). 
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INPUT PARAMETERS (continued) 


FAST 


SHORT 

ONE 

QUERY 


OUTPUT PARAMETERS 
TO 

OVER 

AFTER 

o u t ~pa thname 


Lists only the filenames and directory names in 
the directory* The output format will be five 
columns of filenames unless you also specify the 
ONE parameter (see Figure 3'-3 at the end of this 
command description)* If no listing format is 
specified, FAST is the default. 

Lists the file information in a two-column format 
(see Figure 3-4 at the end of this command 
description). 

Lists the output of a FAST or SHORT listing in 
single -column format. ONE is the default niamber 
of columns for EXTENDED or LONG listings. 

Causes the DIR command to prompt you for 
permission to list a directory by issuing the 
following message: 

pathname, DIR? 


Enter one of the following (followed by a carriage 
return) in response to the query: 


Entry 

Action 


Y or y 

List the directory. 


E or e 

Exit from DIR command. 


R or r 

Continue listing directories 
further query. 

without 

Any other 

Do not list directory; query 

for the 

character 

next directory, if any. 



Copies the directory listing to the specified 
destination data file. If no TO/OVER/AFTER 
preposition is specified, TO :C0: is the default. 

Copies the directory listing to the specified 
output file and writes over (replaces) the 
previous contents. 

Appends the directory listing to the current 
contents of the specified output file. 

Pathname of the file to receive the directory 
listing. If the parameter is omitted, the default 
destination is the user’s console screen (TO : CO : ) . 
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DESCRIPTION 

The amount of information listed for each file depends upon what 
listing format you specify (EXTENDED, FAST, LONG, or SHORT) in the 
DIR command. An example of each type of listing format is provided 
at the end of the DIR command description in Figures 3-1 through 3-4 
respectively. An explanation of the illustrated headings is provided 
in Table 3-2 following the figures. 

If you want to list the default user directory but also wish to 
specify a listing format other than FAST, use the default directory 
name explicitely. For example: 

dir $ extended 

would display a listing of the user directory in the EXTENDED 
format. Note that the default directory is a configuration option. 


ERROR MESSAGES 

pathname, is not a directory 
A pathname exists but is not a directory. 

pathname, directory does not exist 

The pathname does not exist, either as a directory or as a data file. 

pathname, directory LIST access required 
You do not have list access to the directory. 


DIR COMMAND EXAMPLES 


The examples that follow show how a directory’s files are listed when you 
use your configured system’s default prefix in a directory’s pathname. 

In the exan 5 >les, directory names are enclosed in triangles; data file 
names are enclosed in rectangles. 

Assume you have the following directory structure for your files: 
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DIR COMMAND EXAMPLES (continued) 


If your root directory was Q, then the following files would be 
listed in response to the DIR pathname entry examples in the 
following "Pathname” column: 

Pathname Files Listed 


omitted A, f 

f not allowed because f is a data file 

A bb, CB, d 

A/d not allowed because d is a data file 

A/CB e, f 

A/CB/e not allowed because e is a data file 
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DIR LISTING FORMATS 

Figures 3^2, 3-3, and 3-4 show output exaB^les for EXTENDED, FAST* 

LONG, and SHORT listing formats respectively. Table 3-2 defines the 
displayed column headings. 


11 MAR 80 06:30: 30 


DIRECTORY OF 

sys 

ON myvol 














GRAN 





NAME 

AT 

ACC 

BLKS 

LENGTH 

VOL 

FIL 

OWNER 

LAST MOD 

ed 


DR 

200 

30185 

16 

3 

Beck 


20 

NOV 79 





CREATION: 

20 

APR 

78 

ACCESSORS 


ACC 





LAST ACC: 

25 

NOV 

79 

Engineers 


R 









Techs 


tj 

idisk 

DR 

DLAC 

5 

39 

16 

1 

WORLD 

12 

DEC 79 





CREATION: 

15 

NOV 

78 

ACCESSORS 


ACC 





LAST ACC: 

10 

JAN 

80 




submi t$plm$ab 

MA 

DRAU 

11 

1057 

24 

2 

BACKWORDPLMCOM 

16 

JUN 79 





CREATION: 

20 

APR 

78 

ACCESSORS 


ACC 





LAST ACC: 

20 

JAN 

80 

PYE-WACKET 

All 


TOGAN R 

longlongnamess D U 


CHAOTICGOOD 

U 123456789 

1234567890 12345 

123 

Chopin 

01 

DEC 79 



CREATION: 

16 

NOV 

79 

ACCESSORS 


ACC 



LAST ACC: 

20 

FEB 

80 

Clerics 


RA 







MAGIC-USERS 

U 







Thieves 


D 







FIGHTERS 


DRAU 

LAWFULEVIL 

D 73 

9081 

24 

15 

saveyourhat 

04 

JAN 8 0 



CREATION: 

15 

NOV 

79 

ACCESSORS 


ACC 



LAST ACC: 

05 

MAR 

80 

WORLD 


RAU 

5 FILES 

1839 BLOCKS 

1200453 BYTES 






Figure 3-1. EXTENDED Directory Listing Example 


11 MAR 80 04:25:40 

DIRECTORY OF alpha ON mvol 
fnamel fname2 fname3 fname4 
fname6 fnarne? fnameS fname9 
fnamel 1 . . . 


f name 5 
fnamel 0 


Figure 3-2. FAST Directory Listing Exanq>le 
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DIR LISTING FORMATS (continued) 


11 JAN 80 06:- 

DIRECTORY OF 

30:30 

sys ON myvol 


GRAN 





NAME 

AT 

ACC 

BLKS LENGTH 

VOL 

FIL 

OWNER 

LAST MOD 

ed 


DR 

200 30185 

16 

3 

BECK 

20 

NOV 

79 

idisk 

DR 

DLAC 

5 39 

16 

1 

WORLD 

12 

DEC 

79 

LEMONADEIT 

MA 

D 

105 13074 

64 

2 

malag i 

16 

MAR 

77 

credit 


DR 

263 32967 

128 

6 

WORLD 

17 

NOV 

79 

SUBMITAGAINPLM 

MA 

DRAU 

11 1057 

24 

2 

BACKWORDPLMCOM 

16 

JUN 

79 

type 

DR 

LA 

4 366 

16 

1 

PASCAL 

15 

DEC 

79 

CHAOTICGOOD 


U 123456789 1234567890 

12345 

123 

CHOPIN 

01 

DEC 

79 

LAWFULEVIL 

8 FILES 


D 

1839 BLOCKS 

73 9081 24 

1200453 BYTES 

15 

saveyourpet 

04 

JAN 

80 


Figure 3-3. LONG Directory Listing Example 


11 MAR 80|; 04: 25:50 
DIRllCtORY OF sys ON myvol 


NAME 

AT 

ACC 

BLKS 

LENGTH 

NAME 

AT 

ACC 

BLKS 

LENGTH 

append 


R 

40 

1425 

attr ib 


DRAU 

38 

4682 

COPY 

MA 

DRAU 

65 

8042 

CREDIT. HAZ 


R 

263 

33017 

dcopy 


DRAU 

62 

7718 

DELETE 


A 

37 

4506 

REFERENCE 

DR 

L 

5 

10 

DATA 

DR 

DLAC 

1 

4 

DUMP 


D 

22 

2568 

ED 


DR 

200 

30185 

idisk 

DR 

DLAC 

5 

39 






LEMONADEIT 

MA 

D 

123456789 1234567890 





CREDIT 


DR 

263 

32967 

RENAME 


AU 

21 

2487 

submit$plm 

MA 

DRAU 

11 

057 

TYPE 

DR 

LA 

4 

366 

CHAOTICGOOD 


U 

13293 

1151640 

lawf ulevil 


D 

73 

9081 

18 FILES 


1839 1 

BLOCKS 

1200453 

BYTES 






Figure 3-4. SHORT Directory Listing Example 


3-30 



DIR 


Table 3-2. Directory Listing Headings 


Heading 



NAME: 


14-character file NAME 


File ATtribute, where: 

DR = Directory (if the ATtribute field is blank, the 
file is a data file) 

File Access rights, where: 


Directories: 



Delete 

List 

Add 

Change 


DRAU 


Other Files: 



Update 

Append 

Read 

Delete 


BLKS: 


LENGTH: 


Nine-digit number (five digits on SHORT listing) giving the 
volume -granularity units allocated to the file. On the 
SHORT form, if the number of digits exceeds five, the file 
is displayed in the nine-digit form (see the LEMONADEIT 
file in Figure 3-4) . 

lO'ndigit number (7 digits on SHORT listing) giving the 
length of the file in bytes. On the SHORT form, if the 
number of digits exceeds 7, the file is displayed in the 
10-digit form (see the LEMONADIT file in Figure 3-4). 

Five -digit number giving the volume granularity in bytes . 

Three-digit number giving the granularity of the file in 
volume-granularity units. 


OWNER: 


14-character, alphanumeric owner name. 


LAST MOD: 


Date of last file modification. 


LAST ACC: 


Date of last file access. 


CREATION: 


Date of file creation. 


ACCESSORS: 


Heading for list of 14 -character accessor names. 


Heading for access rights of file accessors. The format of 
this field is identical to ACC above. 
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This comioaiid invokes the disk verification utility which verifies the 
data structures of iRMK 86 physical and named volumes. This utility can 
also be used to reconstruct portions of the volume and perform absolute 
editing on the volume. The format of the DISKVERIFY command is as 
follows: 



INPUT PARAMETERS 

:logical~name: Logical name of the secondary storage device 

containing the volume. 

VERIFY or V Performs a verification of the volume. If you 

specify this parameter and omit the options, the 
utility performs the NAMED verification. 

If you specify this parameter, the utility 
performs the verification function and returns 
control to you at the Human Interface level. You 
can then enter any Human Interface command. 

If you omit this parameter, the utility displays a 
slgn-on message and the utility prompt (*). You 
can then enter individual disk verification 
commands. These commands are described in the 
iRMK 86 DISK VERIFICATION UTILITY REFERENCE MANUAL. 


DISKVEKDFY 


INPUT PARAMETERS (continued) 

NAMEDl or N1 VERIFY option that applies to named volumes only* 

This option checks the f nodes of the volume to 
ensure that they match the directories in terms of 
file type and file heirarchy. This option also 
checks the information in each fnode to ensure 
that it is consistent* As a result of this 
option, DISKVERIFY displays a list of all files on 
the volume that are in error, with information 
about each file* Refer to the iRMX 86 DISK 
VERIFICATION UTILITY REFERENCE MANUAL for more 
Information* 

NAMED2 or N2 VERIFY option that applies to named volumes only* 

This option checks the allocation of fnodes on the 
volume, checks the allocation of space on the 
volume, and verifies that the fnodes point to the 
correct locations on the volume. Refer to the 
iRMX 86 DISK VERIFICATION UTILITY REFERENCE MANUAL 
for more information* 

NAMED or N VERIFY option that performs both the NAMEDl and 

NAMED2 verification functions on a named volume* 

If you omit the VERIFY option, NAMED is the 
default option* 

PHYSICAL VERIFY option that applies to both named and 

physical volumes* This option reads all blocks on 
the volume and checks for I/O errors. 

ALL VERIFY option that applies to both named and 

physical volumes * For named volumes , this option 
performs both the NAMED and PHYSICAL verification 
functions. For physical volumes , this option 
performs the PHYSICAL verification function* 


OUTPUT PARAMETERS 

TO Copies the output from the disk verification 

utility to the specified file* If no preposition 
is specified, TO :C0: is the default* 

OVER Copies the output from the disk verification 

utility over the specified file* 

AFTER Appends the output from the disk verification 

utility to the end of the specified file. 
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OUTPUT PARAMETERS (continued) 

outpath Pathname of the file to receive the output from 

the disk verification utility. If you omit this 
parameter and the TO/OVER/AFTER preposition, the 
utility copies the output to the console screen 
(TO :C0:). You cannot direct the output to a file 
on the volume being verified* If you attempt 
this, the utility returns an E$N0T_C0NNECTED error 
message* 


DESCRIPTION 

When you enter the DISKVERIFY command, the utility responds by displaying 
the following line: 

iRMX 86 DISK VERIFY UTILITY, Vx*x 

where Vx*x is the version number of the utility* If you specify the 
VERIFY or V parameter in the DISKVERIFY command, the utility performs a 
verification of the volume and copies the verification information to the 
console (or to the file specified by the outpath parameter). Refer to 
the iRMX 86 DISK VERIFICATION UTILITY REFERENCE MANUAL for a description 
of the verification output* After generating the verification output, 
the utility returns control to the Human Interface, which prompts you for 
more Human Interface commands* The following is an exan 5 >le of such a 
DISKVERIFY command: 

-DISKVERIFY :Fl: VERIFY NAMED2 
iRMX 86 DISK VERIFY UTILITY , Vx*x 

DEVICE NAME = Fl : DEVICE SIZE = 0003E900 : BLOCK SIZE = 0080 

'NAMED2’ VERIFICATION 
BIT MAPS O.K. 


However, if you omit the VERIFY (or V) parameter from the DISKVERIFY 
command, the utility does not return control to the Human Interface. 
Instead, it issues an asterisk (*) as a prompt and waits for you to enter 
individual DISKVERIFY commands* The following is an example of such a 
DISKVERIFY command: 

-DISKVERIFY :Fl: 

* 

After you receive the asterisk prompt, you can enter any of the 
DISKVERIFY commands listed in the IRMX 86 DISK VERIFICATION UTILITY 
REFERENCE MANUAL* 


3-34 



DISKVERIFY 


ERROR MESSAGES 

logical name, 0045 : E$LOG_NAME_NEXIST 

You specified a nonexistent logical name in either the : logical name: 
parameter or the outpath parameter# 

8042 : E$N0TjC0NNECTI0N 

You attempted to direct output to a file on the volume being verified, 
command line error 

You made a syntax error when entering the command. 


device size inconsistent 

size in volume label = valuel : computed size = value2 

When the disk verification utility computed the size of the volume, the 
size it computed did not match the information recorded in the iRMX 86 
volume label. It is likely that the volume label contains invalid or 
corrupted information. This error is not a fatal error, but it is an 
indication that further error conditions may result during the 
verification session. You may have to reformat the volume or use the 
disk verification utility to modify the volume label. Refer to the IRMX 
86 DISK VERIFICATION UTILITY REFERENCE MANUAL for more information about 
the disk verification utility commands. 


logical name, illegal logical name 
The logical name you specified was not surrounded by colons (:). 


not a named disk 

You tried to perform a NAMED, NAMEDl, or NAMED2 verification on a 
physical volume. 

ver if y-f unction argument error 
The VERIFY option you specified is not valid. 


The NAMEDl, NAMED2, and PHYSICAL verification options can also produce 
error messages. Refer to the iRMX 86 DISK VERIFICATION UTILITY REFERENCE 
MANUAL for more information about these messages. 
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EXAMPLE 


The following command {terfoifras both named aiid physical verification of a 
named volume. 

-DISKVERIFY ;Fl; VERIFY ALL 

DEVICE NAME = FI i DEVICE SIZE = 0003E900 : BLK SIZE * 0080 

•NAMEDI' VERIFICATION 

'NAMED2' VERIFICATION 
BIT MAPS O.K. 

•PHYSICAL' VERIFICATION 


NO ERRORS 
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DOWNCOPY 


This command copies files from a volume on an iRMX 86 secondary storage 
device to a volume on an ISIS-II secondary storage device via the 
iSBC 957A/B Interface and Execution package. The format is as follows: 



INPUT PARAMETERS 

inpath-list One or more iRMX 86 pathnames for files, separated 

by commas, that are to be copied to ISIS-II 
secondary storage. Separating blanks between 
pathnames are optional. The files may be copied 
in the listed sequence either on a one-for-one 
basis or concatenated into one or more files. 

QUERY Causes the Human Interface to prompt for 

permission to copy each IRMX 86 file to the listed 
ISIS-II destination file. Depending on which 
preposition you specify (TO, OVER, or AFTER), the 
Human Interface prompts with one of the following 
queries; 

pathname, copy down TO out -pathname? 
pathname, copy down OVER out-pathname? 
pathname, copy down AFTER out-pathname? 


Enter one of 
query: 

the following in response 

to the 

Entry 

Action 


Y or y 

Copy the file. 


E or e 

Exit from the DOWNCOPY 

command 

R or r 

Continue copying files 
further query. 

without 

Any other 
character 

Do not copy this file; query 
for the next file in sequence. 
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OUTPUT PARAMETERS 

TO Reads IRMX 86 files and copies them TO new ISIS-II 

files in the listed sequence. The specified 
output files should not already exist in the 
ISIS*-II directory when the TO parameter is used. 

If a named output file does exist, DOTOCOPY will 
display the following message: 

filename, already exists, delete? 

Enter a Y or y if you wish to delete the existing 
file. Enter any other character if you do not 
wish the existing file to be deleted. 

If no preposition is specified, TO :C0: (ISIS-II 
console screen) is the default. If more input 
files than output files are specified, the 
remaining input files will be appended to the end 
of the last listed ISIS-II file. 

OVER Reads the listed iRMK 86 input files and copies 

them OVER the existing ISIS-II destination files 
in the listed sequence. If more input files than 
output files are listed, the remaining input files 
will be appended to the end of the last listed 
ISIS-II file. 

AFTER Reads the listed iRMK 86 input files and copies 

them AFTER the end of data on the existing ISIS-II 
destination files in the listed sequence. 

outfile-list One or more ISIS-II filenames for the output 

files. Multiple filenames must be separated by 
commas. Separating blanks are optional. If the 
preposition and output file defaults are used in 
the command line, the output will go to the 
ISIS-II console screen. 


DESCRIPTION 

The DOWNCOPY command cannot be used to copy directories from an iRMK 86 
system to an ISIS-II system; only files can be copied. 

Before you enter a DOWNCOPY command on the IRMK 86 console keyboard, you 
must have your target system connected to a development system with the 
957A/B package, and the package must be running. The ISIS-II copies of 
the files will have all ISIS-II file attributes turned off. 

As each file in the input list is copied, one of the following messages 
will be displayed on the Human Interface console output device (:C0:), as 
appropriate: 
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DESCRIPTION (continued) 
pathname, copied 
pathname, copied 
pathname, copied 


down TO out-filename 
down OVER out -filename 
down AFTER out-filename 
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FORMAT 


This command formats or reformats a volume on an iRMX 86 secondary 
storage device, such as a diskette, hard disk, or bubble memory. 

The format is as follows: 



INPUT PARAMETERS 

: logical*-name: Logical name of the physical device-unit to be 

formatted. The logical name must be preceded and 
followed by colons without embedded blanks between 
the logical name and volume name. 

volume-name Six-character, alphanumeric ASCII name, without 

embedded blanks, to be assigned to the volume. 

(See the definition for a "volume” in Chapter 1.) 

FNODES=num Defines the maximum decimal number of files that 

may be created on a NAMED volume. (This parameter 
is not meaningful when formatting a PHYSICAL 
volume and will be ignored if specified for such 
volumes.) The range is 7 through 32,767 fnodes, 
although the maximum number of fnodes you can 
define depends on the settings of the GRANULARITY 
and EXTENSIONSIZE parameters (as explained in the 
"Description" portion of this command write-up). 

If not specified, the default is 50 fnodes. 

GRANULARITY=num Volume granularity; the minimum number of bytes to 

be allocated for each increment of file size on a 
NAMED volume. (This parameter is not meaningful 
for PHYSICAL volumes, and will be ignored if 
specified for such volumes. ) The specified 
decimal number is placed in the header of the 
VO lume and becomes the default file granularity 
when a file is created on the volume. 
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INPUT PARAMETERS 

GRANULARITY=num (continued) 

The range is 1 through 65,535 (decimal) bytes, 
although the maximum allowable volume granularity 
depends on the settings of the FNODES and 
EXTENSIONSIZE parameters (as explained in the 
"Description” portion of this write-up)# If not 
specified, the default granularity is the device 
granualarity# Once the volume granularity is 
defined, it applies to every file created on that 
VO lume • 

EXTENSIONSIZE=num Size, in bytes, of the extension data portion of 

each file descriptor node (fnode). (This 
parameter is not meaningful for PHYSICAL volumes, 
and will be ignored if specified for such 
volumes.) The range is 0 through 65,448 
(decimal), although the maximum allowable 
extension size depends on the settings of the 
FNODES and GRANULARITY parameters (as explained in 
the "Description" portion of this write-up) . If 
not specified, the default extension size is 3 
bytes. 

I NTERLE AVE=num Interleave factor for a NAMED or PHYSICAL volume. 

If not specified, the default value is 5, which is 
the optimum interleave factor for an iSBC 204 
bootstrap load. See the interleave discussion 
under "Description" in this command write-up. 

NAMED The vo lume can store only named files; that is, 

the volume can hold many files (up to the number 
of fnodes allocated), each of which can be 
accessed by its pathname. A diskette or hard disk 
surface are exanples of devices that would be 
formatted for named files . If neither NAMED nor 
PHYSICAL is specified, the vo lume is formatted for 
the type of files specified when you attached the 
device (with the ATTACHDEVICE command). 

PHYSICAL The volume can be used only as a single, physical 

file. The GRANULARITY and FNODES parameters are 
not meaningful when PHYSICAL is specified for the 
vo lume. If neither NAMED nor PHYSICAL is 
specified, the volume is formatted for the type of 
files specified when you attached the device (with 
the ATTACHDEVICE command). 
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DESCRIPTION 

Every physical device-unit used for secondary storage must be formatted 
before it can be used for storing and then accessing its files* For 
exan^le, every time you mount a previously unused diskette into a drive, 
you must enter a FORMAT command to format that diskette as a new volume 
before you can create, store and access files on it* 

Once a volume is formatted, its name becomes a volume identifier when you 
list the root directory for the volume, and the name will appear in the 
directory’s heading* Although the Human Interface uses the volume name 
in its own internal processing when you access the volume, you do not 
need to specify the volume name in any subsequent command after the 
volume is formatted; only the logical name of the secondary storage 
device on which the volume is currently mounted needs to be specified* 

The number of fnodes on a volume defines the number of files that can 
exist on the volume. You can specify this number with with the FNODES 
parameter* Each fnode is a data structure that contains information 
about a file* Each time you create a file on the volume, the Operating 
System records information about the file in an unused fnode. Later, it 
uses the fnode in order to determine the location of the file on the 
volume. 

Each fnode contains a field that stores extension data for its associated 
file* An operating system extension can access and modify this extension 
data by invoking the A$GET$EXTENSION$DATA and A$SET$EXTENSION$DATA system 
calls (refer to the iRMX 86 SYSTEM PROGRAMMER’S REFERENCE MANUAL for more 
information). When you format a volume, you can use the EXTENSIONSIZE 
parameter to set the size of the extension data field in each fnode. 
Although you can specify any size from 0 to 65,448 bytes, the Human 
Interface requires all fnodes to have at least 2 bytes of extension data. 

The default volume granularity is always the granularity of the physical 
device for the volume* For example, if the default granularity for a 
device is 128 bytes of secondary storage, the I/O System will 
automatically allocate 128 bytes of permanent storage to each new file 
you create on that volume, regardless of whether or not a file requires a 
full 128 bytes* If the size of a file exceeds 128 bytes, the I/O System 
will allocate still another full block of 128 bytes, and so on, until the 
volume is full* 

Although the FNODES, GRANULARITY, and EXTENSIONSIZE parameters have 
maximum values which are listed in the parameter descriptions, the 
combination of these three parameters must also satisfy the following 
formula: 

(87 + EXTENSIONSIZE) x FNODES / GRANULARITY < 65535 

where all numbers are decimal* FORMAT displays an error message if the 
combination of parameter values exceeds the limit* 
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DESCRIPTION (continued) 

As stated previously, the interleave factor applies to volumes formatted 
either for NAMED or PHYSICAL files. The interleave specification 
maximizes access speed for the files on a given volume, depending on the 
intent of volume and the device configuration. For example, an 
interleave factor of 5 for a flexible disk drive means that, for each 
file, the I/O System will read every fifth sector on the diskette, 
starting with an index of 1 (other, hard disk systems may be different, 
depending on your configuration). Therefore, the I/O System does not 
need to wait for the disk to make a complete revolution before it 
accesses the next sector; the next sector by an increment of 5 is ready 
to be accessed for read/ write by the time the previously accessed sector 
has been processed. 

The FORMAT command displays the following message when volume formatting 
is completed: 

volume (vol'-name) will be formatted as a NAMED/ PHYSICAL volume 
granularity = number 
interleave = number 
numberfnodes = number 
extensionsize = number 


where: 

vol-name The volume name specified in the FORMAT command. 

NAMED/PHYSICAL Either NAMED or PHYSICAL will be displayed in the 

message, depending on the command specification. 

number Default or specifically defined in the command. 


ERROR MESSAGES 

If a device cannot be detached for formatting, the following message is 
displayed on the user console: 

logical-name, can*t detach device 

which means that the volume does not exist, the volume is busy, or the 
device on which the volume is mounted is not currently attached to the 
system. 

If the device cannot be attached for formatting, or it cannot be 
re-attached (e.g., restored to its original configuration prior to 
formatting) after formatting takes place, the following message is 
displayed on the user console: 

device-name, can*t attach device 
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ERROR MESSAGES (continued) 

The following error message is displayed if you attempt to format 
something that is not a physical device: 

logical-name, is not a device connection 

The following error message is displayed if you specify a volume name 
containing more than six ASCII characters or if you specify a logical 
device name: 

vol-name, illegal name 

The following error message is displayed if you specify an out-of-range 
number for any of the FNODES, GRANULARITY, EXTENSIONSIZE, or INTERLEAVE 
parameters: 

number, illegal number 

The following message is displayed if the values you specify for fnode 
size, granularity, and extension data size cause the formula listed in 
the "Description” section to exceed its limit* 

vol-name, fnode file size exceeds 65535 volume blocks 
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RENAME 


This conffiiand allows you to change the pathname of one or more data files 
or directories. RENAME is effective across directory boundaries on the 
same volume. The format is as follows: 



INPUT PARAMETERS 

inpath~list One or more pathnames, separated by commas, of 

files or directories that are to be renamed. 

Blanks between pathnames are optional separators. 

QUERY Causes the Human Interface to prompt for 

permission to rename each pathname in the input 
list by issuing the following message: 

oldname, RENAME? 

Enter one of the following (followed by a carraige 
return) in response to the query: 


Entry 

Action 


Y or y 

Rename the file. 


E or e 

Exit from RENAME command. 


R or r 

Continue renaming without 
query. 

further 

Any other 

Do not rename file; query 

for the next 

character 

file in sequence. 



OUTPUT PARAMETERS 

TO Moves the data to the new pathnames in the output 

list. A new pathname in the output list should 
not already exist. If, in fact, a new pathname 
does already exist, RENAME displays the following 
warning message when the pre-existing pathname is 
encountered: 

pathname, already exists, DELETE? 


3-45 


RENAME 


OUTPUT PARAMETERS 

TO (continued) Enter a *’Y” or if wish the pre-existing 

pathname and its contents to be written over by the 
new name specification. The pre-existing pathname 
and its contents will be deleted. 

Enter any other character if you do not wish the 
pre-existing file to be deleted. Renaming of the 
specified file will not take place and the RENAME 
command will attempt to rename the next pathname in 
the list sequence. 

OVER Changes each old pathname in a list to the 

corresponding new pathname, even if the new pathname 
already exists. The old pathname is deleted from 
secondary storage. OVER cannot be used to rename a 
non-empty directory over another non-empty 
directory. 

outpath-list List of new pathnames. Multiple pathnames must be 

separated by commas. Separating blanks are optional. 


DESCRIPTION 

The primary distinction between the RENAME command and the COPY command is 
that, as a RENAME command is executed, it releases the pathnames in the 
listed input files for new uses without having to perform any further 
operation on the files. 

Although RENAME can be used to rename an existing directory pathname TO a 
new pathname, it cannot be used to rename an existing directory OVER 
another existing directory. For example: 

-rename ALPHA to DELTA allowed 

-rename ALPHA over BETA not allowed (unless BETA is enpty) 

-rename ALPHA/sampl over BETA/testl allowed 

CAUTION 

Note that changing the name of a 
directory also changes the path of all 
files listed under that directory. All 
subsequent accesses to those files must 
specify the new pathnames for the files. 


As each file in a pathname list is renamed, the RENAME command displays 
one of the following messages, as appropriate: 

old-pathname, renamed TO new-pathname 

or 

old-pathname, renamed OVER new-pathname 
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ERROR MESSAGES 

There must be a one-for-one correspondence between the oldname and 
newname lists in the RENAME command. A missing element in either list 
causes RENAME to display the following message: 

unmatched path name lists 

If your system is configured with user-designed access limitations, you 
must have at least delete access to old pathnames and add-entry access to 
the destination directory to use the RENAME command. 

If you are not allowed delete access on your system, the following 
message is displayed when you atten|>t to use the OVER preposition in a 
RENAME command: 

old-pathname, DELETE access required 

If you are not allowed add-entry access on your system, the following 
message is displayed when you atten^)! to use the TO preposition in a 
RENAME command: 

new-pathname, directory ADD ENTRY access required 

If the RENAME command encounters an error in the renaming of a file, it 
will attempt to continue renaming each succeeding file in sequence. 

Use of the AFTER preposition is not valid for the RENAME command, and an 
attenqpt to use it causes the following message to be displayed: 

AFTER preposition, TO or OVER preposition expected 

Note that the RENAME command is the only Human Interface file handling 
command that cannot be used across volume boundaries; that is, you cannot 
use the RENAME command to rename a file or move data from a volume 
located on one secondary storage device to a volume located on another 
secondary storage device (e.g., from one diskette to another). An 
attempt to do so causes the following error message: 

0005: E$C0NTEXT 

Use the COPY command or a combination of COPY and DELETE commands if you 
wish to rename files or move data across volume boundaries. 
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This coinmand resto files to a named volume by copying them from a 
backup volume^ 

The format of this command is as follows: 



INPUT PARAMETERS 

: backup device: Logical name of the backup device from which 

RESTORE restores files. 

QUERY Causes the Human Interface 

permission to restore each 
Interface pronpts with one 
queries: 

pathname, RESTORE data file? 


to prompt for 
file. The Human 
of the following 


or 


pathname, RESTORE directory? 

Enter one of the following responses to the query: 


Entry 

Action 

Y or y 

Restore the file. 

E or e 

Exit from the RESTORE command. 

R or r 

Continue restoring flies without 
further query. 

Any other 

If data file, do not restore the 

character 

file; If directory file, do not 
restore the directory or any 
file In that portion of the 
directory tree. Query for the 
next file. If any. 
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OUTPUT PARAMETERS 

TO Restores the files from the backup volume to new 

files on the named volume, if the files do not 
already exist on the named volume* However, if a 
file being restored already exists on the named 
volume, RESTORE prompts for permission to restore 
the file* 

OVER Restores the files from the backup volume over 

(replaces) the files on the named volume. If a 
file does not exist on the named volume, RESTORE 
creates a new file on the named volume* 

pathname Pathname of a file which receives the restored 

files (you must specify a directory pathname when 
restoring more than one file). If you specify a 
logical name for a device, RESTORE places the 
files under the root directory for that device* 
However, the device must contain a volume 
formatted as a named volume* If you wish to 
restore files to the directory in which they 
originated, you should specify the same pathname 
parameter as you used with the BACKUP command* 


DESCRIPTION 

RESTORE is a utility which copies files from backup volumes (where the 
BACKUP command originally saved them) to named volumes. RESTORE copies 
the files to any directory you specify, maintaining the hierarchical 
relationships between the backed-up files. 

When RESTORE copies files, it copies only those files for which you are 
the owner* For these files, it restores the following information: 

• File name 

• Access list 

• Extension data 

• File granularity 

• Contents of the file 

RESTORE changes the creation, last modification, and last access dates of 
the file to the current date* 

Each backup volume which is used as input to the RESTORE command must 
contain files placed there by the BACKUP command* In addition, if the 
backup operation required multiple backup volumes, you must restore these 
volumes in the same order as they were backed up* 
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DESCRIPTION (continued) 

The output volume which receives the restored files must be a named 
volume. You must have sufficient access rights to the files in that 
volume to allow RESTORE to perform all necessary operations. In order 
for RESTORE to create new files on a named volume, you must have add 
entry access to directories on that volume. In order for RESTORE to 
restore files over existing files, you must have add entry and change 
entry access to directories in that volume and delete, append, and update 
access to data files. 

When you enter the RESTORE command, RESTORE displays the following 
sign-on message: 

iRMX 86 DISK RESTORE UTILITY Vx.x 

where Vx.x is the version number of the utility. Then it prompts you for 
a backup volume. 

Whenever RESTORE requires a new backup volume, it issues the following 
message: 

backup device, mount backup volume #nn, enter Y to continue: 

where backup device Indicates the logical name of the backup device and 
nn the number of the requested volume. (RESTORE in some cases displays 
additional information to indicate problems with the current volume.) In 
response to this message, place the backup volume in the backup device 
(make sure that the volume number is correct if the backup operation 
involved multiple volumes). Enter one of the following: 

Entry Action 

Y, y, R, or r Continue the restore process. 

E or e Exit from the RESTORE command. 

Any other Invalid entry; reprompt for entry, 

character 

RESTORE continues prompting you until you supply the correct backup 
volume. 

As it restores each file, RESTORE displays the following message at the 
Human Interface console output device (:C0:): 

pathname, RESTORED 

However, if a file with the same pathname already exists during a restore 
operation using the TO preposition, RESTORE displays the following 
message: 

pathname, already exists, DELETE? 
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Enter one of the following in response to the query: 


Entry 
Y or y 

E or e 


Action 

Delete the file and replace it with the one from 
the backup volume* 

Exit from the RESTORE command. 


R or r 


Any other 
character 


Delete the file, replace it with the one from the 
backup volume, and continue restoring files 
without further queries. 

Do not restore the file; go on to the next file. 


ERROR MESSAGES 

pathname, ADD ENTRY or UPDATE access required 

RESTORE could not restore a file, either because you did not have add 
entry access to the filers parent directory or because you did not have 
update access to the file. RESTORE continues with the next file. 


backup device, backup volume #nn, date, mounted 
backup device, backup volume #nn, date, required 

backup device, mount backup volume #nn, enter Y to continue: 

RESTORE cannot continue because the backup volume you supplied is not the 
one that RESTORE expected. Either you supplied a volume out of order or 
you supplied a volume from a different backup session. RESTORE repronpts 
for the correct backup volume. 


backup device, cannot attach volume 
backup device, exception code 

backup device, mount backup volume #nn, enter Y to continue: 

RESTORE cannot access the backup volume. This could be because there is 
no volume in the backup device, the volume is write protected, or because 
of a hardware problem with the device. The second line of the message 
indicates the iRMX 86 exception code encountered. RESTORE continues to 
issue this message until you supply a volume that RESTORE can access. 
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ERROR MESSAGES (continued) 

pathname, DELETE access required 

RESTORE could not restore a file because you did not have delete access 
to the file* RESTORE continues with the next file. 


pathname, exception code, error during BACKUP, file not restored 

When the BACKUP utility saved files, it encountered an error when 
attenpting to save the file Indicated by this pathname. RESTORE is 
unable to restore this file. The message lists the iRMK 86 exception 
code encountered. 


pathname, exception code, error during BACKUP, restore incomplete 

When the BACKUP utility saved the files, it encountered an error when 
atten5>ting to save the file indicated by this pathname. RESTORE restores 
as much of the file as possible to the named volume. The message lists 
the iRMX 86 exception code encountered. 


backup device, error reading backup volume 
backup device, exception code 

RESTORE tried to read the backup volume but encountered an error 
condition, possibly because of a faulty area on the volume. The second 
line of the message indicates the IRMX 86 exception code encountered. 

pathname, exception code, error writing output file, restore incoB^lete 

RESTORE encountered an error while writing a file to the named volume. 

This message lists the iRMX 86 exception code encountered. RESTORE 
writes as much of the file as possible to the named volume. 


pathname, extension data not completely restored, nn bytes required 

The amount of space available on the named volume for extension data is 
not sufficient to contain all the extension data associated with the 
specified file. The value nn Indicates the number of bytes required to 
contain all the extension data. This message Indicates that the named 
volume on which RESTORE is restoring files is formatted differently than 
the named volume which originally contained the files. RESTORE restores 
as much of the extension data as possible. To ensure that you restore 
all the extension data from the backup volume, you should restore the 
files to a volume formatted with an extension size set equal to the 
largest value reported in any message of this kind. Refer to the 
description of the FORMAT command for information about setting the 
extension size. 
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ERROR MESSAGES (continued) 

pathname, file does not exist 

The pathname you specified as input to RESTORE does not represent an 
existing file or device. 

pathname, file not restored 

For some reason, RESTORE was unable to restore a file from the backup 
volume. RESTORE continues with the next file. Another message usually 
precedes this message to indicate the reason for not restoring the file. 


backup device, invalid logical name 

The logical name you specified for the backup device contains unmatched 
colons, is longer than 12 characters, contains invalid characters, or 
does not exist. 


backup device, not a backup volume 

backup device, mount backup volume #nn, enter Y to continue: 

The volume you supplied on the backup device was not a backup volume. 
RESTORE continues to issue this message until you supply a backup volume. 

backup device, not a valid backup device 

The logical name you specified for the backup device was not a logical 
name for a device. 

output specification missing 

You did not specify a pathname to indicate the destination of the 
restored files. 

pathname, READ access required 

You do not have read access to a file on the backup volume ; therefore 
RESTORE cannot restore the file. 

keyword, too many values 

You specified too many values after the TO or OVER parameter. 
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ERROR MESSAGES (contintied) 

keyword, unrecognized control 

You entered an invalid optional parameter. The keyword portion of the 
message indicates the parameter that is in error* 


pathname, exception code 

The pathname you specified as input to RESTORE is in error* This error 
could occur if you specify an invalid or nonexistent path con^onent* 
This message displays the exception code that results from this error* 
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This connnand reads and executes a set of commands from a file in 
secondary storage instead of from the console keyboard. To use the 
SUBMIT command you must first create a data file that defines the command 
sequence and formal parameters (if any). 

The format of the command is as follows: 



INPUT PARAMETERS 

pathname Name of the file from which the commands will be 

read. This file may contain nested SUBMIT files. 

parameter-list Actual parameters that are to replace the formal 

parameters in the SUBMIT file. You must surround 
this parameter list with parentheses. You can 
specify as many as 10 parameters, separated by 
commas, in the SUBMIT command. If you omit a 
parameter, you must reserve its position by 
entering a comma. If a parameter contains a 
comma, space, or parenthesis, you must enclose the 
parameter in single quotes. The sum of all 
characters in the parameter list must not exceed 
512 characters. 


OUTPUT PARAMETERS 

TO Causes the output from each command in the SUBMIT 

file to be written to the specified new file 
Instead of the console screen. If the listed 
output file already exists, the SUBMIT command 
will display the following message: 

pathname, already exists DELETE? 

Enter a Y or y if you wish the existing output 
file to be deleted. Enter any other character if 
you do not wish the existing file to be deleted. 

A response other than Y or y causes the SUBMIT 
command to be terminated and you will be prompted 
for a new command entry. 
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OUTPUT PARAMETERS (continued) 

OVER Causes the output for each command in the SUBMIT 

file to be written over the specified existing 
file instead of the console screen* 


AFTER 


outpath-list 


Causes the output from each command in the SUBMIT 
file to be written to the end of an existing file 
instead of the console screen. 

Pathnames of one or more files to receive the 
processed output from each command executed from 
the SUBMIT file. If no preposition or output file 
is specified, TO :C0: is the default. 


DESCRIPTION 

Any program that reads its commands from the console keyboard can be 
executed from a SUBMIT file. If another SUBMIT command is itself used in 
a SUBMIT file, it causes another SUBMIT file to be invoked. You can nest 
SUBMIT files to any level of nesting until memory is exhausted. When one 
nested SUBMIT file completes execution, it returns control to the next 
higher level of SUBMIT file. 

When you create a SUBMIT file, you indicate formal parameters by 
specifying the characters %n, where n ranges from 0 through 9. When 
SUBMIT executes the file, it replaces the formal parameters with the 
actual parameters listed in the SUBMIT command (the first parameter 
replaces all instances of %0, the second parameter replaces all instances 
of %1, and so forth). If the actual parameter is surrounded by quotes, 
SUBMIT removes the quotes before performing the substitution. If there 
is no actual parameter that corresponds to a formal parameter, SUBMIT 
replaces the formal parameter with a null string. 

When you specify a preposition and output file in a SUBMIT command, only 
your SUBMIT command entry will be echoed on the console screen; the 
individual command entries in the submit file are not displayed on the 
screen as they are loaded and executed. 

The SUBMIT command will display the following message when all commands 
in the submit file have been executed: 

END SUBMIT pathname 
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EXAMPLE 

This example shows a SUBMIT file that uses formal parameters and the 
command that you can enter to invoke this SUBMIT file. The SUBMIT file, 
which resides on file :F1:PR0GRAM, contains the following lines: 

ATTACHDEVICE Fl AS %0 

CREATEDIR %0/%l 

UPCOPY :F1;%2 TO %0%l/%2 

The SUBMIT file contains three formal parameters, indicated by %0, %1, 
and %2. The %0 indicates the logical name of an iRMX 86 device; the %1 
indicates the name of a directory on that device; the %2 indicates the 
name of a file which will be copied from an ISIS-II disk to the iRMX 86 
device. 

The SUBMIT command used to invoke this file is as follows: 

-SUBMIT :F1; PROGRAM (:F1:, PROG, FILEl) 

The command sequence created and executed by SUBMIT is shown as it would 
be echoed on the console output device. 

-ATTACHDEVICE Fl AS :Fl: 

Fl, attached as :F1: 

-CREATEDIR ;Fl:/PROG 
:F1:PR0G, directory created 
-UPCOPY :F1: FILEl TO : Fl : PROG/F ILEl 
:F1: FILEl upcopied TO :F1:PR0G/FILE1 
END SUBMIT :Fl: PROGRAM 
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TIME 


This coismand sets the system clock. If no new time is entered, the TIME 
command causes the current system time to be displayed. 

The format is as follows: 



IMFUT PARAMETERS 

hh: Hours specified as 0 through 24. 

mm: Minutes specified as 0 through 59. 

ss Seconds specified as 0 through 59. 

DESCRIPTION 

If one of the time entries in the parameter string is set, all three must 
be; there are no default settings for individual items in the parameter 
string. 

If you request the time~of-day and the system clock has not been set, the 
TIME command displays the following message: 

00 : 00:00 

See also the DATE command in this chapter if you wish to set the date in 
conjunction with the system clock. 

An invalid time or an out*of~range entry for the TIME command causes the 
following error message to be displayed: 

illegal time 
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UPCOPY 


This command copies files from a volume on ISIS-II secondary storage to a 
volume on iRMX 86 secondary storage via the iSBC 957A/B interface and 
Execution package. 



INPUT PARAMETERS 

inpath-list List of one or more filenames of the ISIS-II files 

that are to be copied to iRMX 86 secondary 
storage, either on a one-for-one basis or 
concatenated into one or more iRMX 86 output files. 

QUERY Causes the Human Interface to pron 5 )t for 

permission to copy each ISIS-II file to the listed 
iRMX 86 output file. Depending on which 
preposition you specify (TO, OVER, or AFTER), the 
Human Interface prompts with one of the following 
queries: 

filename, copy up TO out-pathname? 

filename, copy up OVER out -pathname? 

filename, copy up AFTER out-pathname? 

Enter one of the following (followed by a carriage 
return) in response to the query: 


Entry 

Action 



Y or y 

Copy the file. 



E or e 

Exit from the UPCOPY command. 

R or r 

Continue copying 
further query. 

files 

without 

Any other 
character 

Do not copy this 
the next file in 

file; go to 
sequence. 
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OUTPUT PARAMETERS 

TO Copies the ISIS-II file or files TO a new IRMX 86 

file or files in the listed sequence* The output 
file or files should not already exist when the TO 
preposition is used* If no preposition is 
specified, TO :C0: is the default* If more input 
files than output files are specified in the 
command line, the remaining inputfiles will be 
appended to the end of the last listed output file* 

OVER Copies the listed ISIS-II input file or files OVER 

existing iRMX 86 destination files in the listed 
sequence* If more input files than output files 
are listed in the command line, the remaining 
input files will be appended to the end of the 
last listed output file. 

AFTER Appends the listed ISIS-II input file or files 

AFTER the end-of-data on an existing iRMX 86 
output file or files in the listed sequence* 

outpath-list One or more pathnames of the iRMX 86 destination 

files* Multiple pathnames muxt be separated by 
commas* Separating blanks are optional* If the 
preposition and output parameter defaults are used 
in the command line, the output will go to the 
iRMX 86 console screen* 


DESCRIPTION 

Before you enter an UPCOPY command on the iRMX 86 console keyboard, you 
must have your target system connected to a development system with the 
957A/B package and the package must be running* The iRMX 86 copies of 
the files will have WORLD access; that is, all IRMX 86 system users can 
peform read, write, and delete operations on the files without 
restriction. 

As each ISIS-II file in the input list is copied, the Human Interface 
will display one of the following messages on the iRMX 86 console screen, 
as appropriate: 

filename, copied up TO out-pathname 
filename, copied up OVER out-pathname 
filename, copied up AFTER out-pathname 
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Your programs request IRMX 86 PC Operating System services through the 
Universal Development Interface (UDI) system calls. This chapter 
describes the set of system calls that are available to iRMX 86 PC 
programs. Although the iRMX 86 Operating System can recognize many other 
system calls, (these are listed in Appendix B) you can perform all normal 
operations with UDI calls. This is a design characteristic of the UDI; 
it forms a "membrane” through which your programs send requests to the 
Operating System, and through which the Operating System returns 
information to programs. 


This chapter contains these four sections: 

• USING THE UDI . This section outlines general programming 
considerations for using the Universal Development Interface. 

For example, this section explains how to use UDI libraries and 
how to deal with errors in programs. 

• TYPES OF UDI SYSTEM CALLS . This section explains certain 
concepts about UDI File Management and Memory Management system 
calls. For example, the concept of a file connection is 
explained here. 

t DESCRIPTIONS OF SYSTEM CALLS. Here is the heart of this 

chapter. Each UDI system call is described in detail, with an 
explanation of how the call is invoked. The calls are arranged 
alphabetically for quick reference. At the beginning of this 
section you will find a System Call Dictionary: a brief listing 
of system calls arranged into these functional groupings: 

- Memory Management 

- File Handling 

- Program Control 

- Exception Handling 

~ Utility and Command Parsing 

• EXAMPLE PROGRAM: At the end of this chapter is the listing of a 

PL/M-86 program that uses a representative sample of UDI system 
calls. 
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USING THE UDI 

This section contains information about: 

• UDI Libraries and INCLUDE files 

• Exceptional conditions such as hardware errors 

• Special data types referred to in descriptions of UDI system calls 


UDI LIBRARIES 

To execute a program which uses UDI system calls, you must link the 
program to one of three iRMX 86 UDI libraries. These libraries are 
called URXLRG.LIB, URXSML.LIB, and URXCOM.LIB. If your program 
corresponds to the LARGE or MEDIUM models of segmentation, link it to 
URXLRG.LIB. If your program corresponds to the SMALL or COMPACT models 
of segmentation, link it to URXSML.LIB or URXCOM.LIB, respectively. 

These libraries are in the UDI directory under the directory SYSTEM. The 
pathname for the COMPACT library, for example, is SYSTEM/UD I /URXCOM.LIB. 

The iRMX 86 PROGRAMMING TECHNIQUES manual discusses selecting a model of 
segmentation. While these models deal with the PL/M 86 language, they 
apply to assembly language as well. In contrast, Pascal-86 and 
FORTRAN-86 require the large library. 


INCLUDE FILES 

You must declare each UDI procedure used in your PL/M-86 programs as an 
EXTERNAL procedure. These declarations are contained in a single file 
named SYSTEM/UDI/UDI.EXT. You INCLUDE this file with a PL/M-86 program 
that makes UDI system calls. You can edit this file to delete references 
that you don^t use in your programs. 


EXCEPTIONAL CONDITIONS 

Every UDI call except DQ$EXIT returns a condition code which specifies 
the status of the call. Each condition code has a unique numeric value, 
and an associated mnemonic by which it is known. For example, the code 
Indicating that there were no errors or unusual conditions has the 
numeric value zero (0) and the name E$0K. Any code other than E$0K 
returned from a system call means there was an exceptional condition. 
Exception codes are classified as: 

• Environmental Exceptions. These are generally caused by 

conditions outside the control of a program; for example, device 
errors or insufficient memory. 
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• Programmer Errors * These are typically caused by coding errors 
(for example, "bad parameter”), but ”divide-by-zero ”, "overflow”, 
"range check”, and errors detected by the 8087 Numeric Processor 
Extension are also classified as avoidable. 

When an error is detected, the normal (default) system action is to 
display on the console terminal an error message, and terminate the 
program. However, you may establish your own routine to handle 
exceptions by using the UDI system calls DQ$TRAP$EXCEPTION and 
DQ$DECODE$EXCEPTION. 

Appendix A contains a list of exception codes that the iRMX 86 Operating 
System can return, with the numeric value, mnemonic, and meaning of each 
code. 


DATA TYPES 

The following data types are referred to in the descriptions of system 
calls: 

BYTE An 8-bit item. 

WORD A two-byte item. 

STRING A sequence of bytes, the first of which contains the 

length (in bytes) of the remaining portion of the 
string. A length of zero Indicates a null string. 

TOKEN A WORD passed between a program and the Operating System 

to represent an object; for example, a CONNECTION is a 
token used in File Management System calls to represent a 
file. In PL/M-86: 

DECLARE TOKEN LITERALLY ’WORD’; 

POINTER Equivalent to PL/M-86 type POINTER. It is two bytes 
under the small model of segmentation; four bytes in 
other cases. 

CONNECTION A token used to manipulate iRMX 86 files. In PL/M-86: 
DECLARE CONNECTION LITERALLY ’WORD’; 

SELECTOR Equivalent to the PL/M-86 type SELECTOR; a 16-bit 
iAPX 86,88 paragraph number (the base portion of a 
four-byte pointer). 
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DESCRIPTIONS OF SYSTEM CALLS 

This section contains descriptions of each UDI system call. The calls 
are arranged alphabetically. Before the first system call description, a 
System Call Dictionary (Table 4-1) shows the calls arranged in functional 
groups, with a short description of each call and the page number of the 
description. 

Every system call description contains the following information in the 
order listed here: 

• The name of the system call. 

• A brief summary of the function of the call. 

• The form of the call as it is invoked from a PL/M-86 program, 
with symbolic names for each parameter. (Calling sequences show 
formal parameters in lower case.) 

• Definition of input and output parameters. 

• A complete explanation of the system call, including any 
Information you will need to use the system call. 


NOTE 

The first system call described, 
DQ$ALLOCATE, also Includes an actual 
(as opposed to formal) PL/M-86 
invocation of the system call and an 
ASM-86 calling sequence. These are 
included only once because they are 
typical of all system calls. 


MEMORY MANAGEMENT SYSTEM CALLS 

When the iRMX 86 Operating System loads and runs a program, the program 
is allocated a specific amount of memory. The portion of memory not 
occupied by loaded code and data — the free space pool — is available to 
programs dynamically, i.e. , while the program is running. The Operating 
System manages memory as segments of the size a program requests. 

Your programs can use the UDI system calls DQ$ALLOCATE, and DQ$FREE, 
respectively, to get a memory segment from the pool, and to return the 
segment to the pool. You can use the call DQ$GET$SIZE to receive 
information about an allocated memory segment. 
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FILE-HANDLING SYSTEM CALLS 

About one-half of UDI system calls are used to manipulate files. Figure 
4-1 shows the chronological relationship between the most frequently used 
file-handling system calls. 


ATTACH 


OPEN 


CREATE 




READ WRITE 
SEEK 

TRUNCATE 


CLOSE 


DETACH 


DELETE 


Figure 4-1. Chronology Of System Calls 


The IRMX 86 Operating System distinguishes between: 

• Establishing the association between a program and a data file 

• Operating on the data file 

The association between a program and a data file is a connection , and is 
represented in your programs by a token of type CONNECTION. 

Your programs establish a connection by using the system calls DQ$ATTACH 
or DQ$CREATE and break the connection with DQ$DETACH. When your program 
establishes a connection via DQ$ATTACH or DQ$CREATE, it receives a 
CONNECTION token from the operating system. You use this token in all 
further communications with the operating system to identify the file. 

You use the procedure DQ$OPEN to prepare an established connection for 
input/output operations. You perform the actual input or output 
operations with DQ$READ and DQ$WRITE. You can move the file pointer with 
the DQ$SEEK call. When input/output is finished, you close the file 
connection with DQ$CLOSE. Note that you open and close connections, not 
files. Closing a file connection frees buffer space. Once a connection 
is established, it may be opened and closed as often as necessary. 

DQDETACH is the call that eliminates a connection, and DQ$DELETE deletes 
a file. If a file has connections attached when a program Issues 
DQ$DELETE, the Operating System will mark for deletion the file. That 
is, the file is not actually deleted until all connections are detached. 
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EXCEPTION-HANDLING SYSTEM CALLS 

When an exceptional condition occurs while the iRMX 86 Operating System 
is running a user program, the default exception handler (part of the 
Operating System) will terminate the program and display a message on the 
terminal identifying the exception code. You can write a program to 
handle exception codes, rather than using the default exception handler. 
In this case, the Operating System will not terminate your program, but 
will pass control to your exception handler. Three system calls are used 
to define and use your own exception handler: 

• DQ$TRAP$EXCEPTION, which is used to identify an exception handler 
that you provide. 

• DQ$GET$EXCEPTION$HANDLER, which is an informative system call 
returning the address of the current exception, handler: either 
the default system handler, or one you specify with 
DQ$TRAP$EXCEPTION 

• DQ$DECODE$EXCEPTION, which converts an exception numeric code 
into its equivalent mnemonic. 

Before your exception handler gets control, the iRMX 86 Operating System 
does the following: 

1. Pushes the condition code onto the stack. 

2. Pushes the number of the parameter that caused the exception onto 
the stack (1 for the first parameter, 2 for the second, etc.). 

3. Pushes a word onto the stack (reserved for future use). 

4. Pushes a word for the 8087 Numeric Processor Extension onto the 
stack. 

5. Initiates a long call to the exception handler. 

If the condition was not caused by an erroneous parameter, the 
responsible parameter number is zero. If the exception code is E$NDP, 
the fourth item pushed onto the stack is the 8087 status word, and 8087 
exceptions have been cleared. 

Programs compiled under the SMALL model of segmentation cannot have an 
alternate exception handler, but must use the default system exception 
handler. This is because the exception handler must have a LONG POINTER, 
which is not available with SMALL segmentation. 
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Table 4-1. SYSTEM CALL DICTIONARY 


SYSTEM CALL 

FUNCTION PERFORMED 

PAGE 

MEMORY MANAGEMENT CALLS 

DQ$ ALLOCATE 

Creates a segment of a specified size for use 
by the application* 

4-9 

DQ$FREE 

Returns the specified segment to the system. 

4-11 

DQ$GET$SIZE 

Returns the size of the specified segment. 

4-25 

FILE-HANDLING CALLS 

DQ$ATTACH 

Creates a connection to a specified file. 

4-11 

DQ$CHANGE$ EX- 
TENSION 

Changes the extension of a file name. 

4-12 

DQ$CLOSE 

Closes the specified file connection. 

4-13 

DQ$CREATE 

Creates a file for use by the application. 

4-14 

DQ$DELETE 

Deletes a file. 

4-16 

DQ$DETACH 

Closes a file and deletes its connection. 

4-17 

DQ$GET$CON- 

NECTION$STATUS 

Returns status of a file connection. 

4-22 

DQ$OPEN 

Opens a file for a particular type of access. 

4-28 

DQ$READ 

Reads the next sequence of bytes from a file. 

4-32 

DQ$RENAME 

Renames the specified file. 

4-34 

DQ$SEEK 

Moves the current position pointer of a file. 

4-35 

DQ$SPECIAL 

Sets terminal line-edit /tranparent mode. 

4-37 

DQ$TRUNCATE 

Truncates a file to the specified length. 

4-41 

DQ$WRITE 

Writes a sequence of bytes to a file. 
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Table 4-1. SYSTEM CALL DICTIONARY (continued) 


SYSTEM CALL 

FUNCTION PERFORMED 

PAGE 

PROGRAM CONTROL 

DQ$EXIT 

Exits from the current application job. 

4-18 

DQ$OVERLAY 

Causes the specified overlay to be loaded. 

4-30 

EXCEPTION-HANDLING CALLS 

DQ$DE- 

CODE$EXCEPTION 

Returns a short description of a 
specified error code. 

4-15 

DQ$GET$EXCEPT- 

ION$HANDLER 

Returns a POINTER to the address of the 
program currently being used to process 
errors. 

4-24 

DQ$TRAP$EXCEPTION 

Identifies a custom exception processing 
program for a particular type of error. 

4-40 

UTILITY AND COMMAND PARSING 


DQ$GET$ARGUMENT 

Returns the next argument from the 
character string used to invoke the 
application program. 

4-20 

DQ$GET$SYS- 

TEM$ID 

Returns the name of the underlying 
operating system supporting the UDI. 

4-26 

DQ$GET$TIME 

Returns the current time of day as kept 
by the underlying operating system. 

4-27 

DQ$SWITCH$BUFFER 

Selects a new buffer from which to process 
commands. 

4-39 
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DQ$ALLOCATE I 


DQ$ALLOCATE requests a memory segment from the free memory pool. 


base$addr = DQ$ALLOCATE (size, except$ptr); 


INPUT PARAMETER 

size A WORD which, 

• if not zero, contains the size, in bytes, of the 
requested segment. If the size parameter is not a 
multiple of 16, it will be rounded up to the nearest 
multiple of 16. 

• if zero, indicates that the size of the request is 
65536 (64K) bytes. 


OUTPUT PARAMETERS 

base$addr A SELECTOR in which the Operating System places the 

base address of the memory segment. If the request 
fails because the memory requested is not available, 
this argument will be OFFFFH, and the system will 
return an E$MEM exception code. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

The DQ$ALLOCATE system call is used to request additional memory. You may 
use this call for dynamically creating buffer space. 


EXAMPLE CALL PROCEDURES 

These exaiiq>les are included only for DQ$ALLOCATE. Their form is typical 
of all system calls. 
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A I iL 


EXAMPLE CALL PROCEDURES (continued) 

Both examples request 128 (decimal) bytes of memory, and point to a word 
named "ERR” for receiving the condition code). 


Example PL/M-86 Calling Sequence 

DECLARE ARRAYJBASE WORD, 

ERR WORD; 



ARRAYBASE = DQ$ALLOCATE (128, @ERR); 


Example ASM86 Calling Sequence 


MOV AX, 128 

PUSH AX ; first parameter 

LEA AX, ERR 

PUSH DS ; second parameter 

PUSH AX ; 

CALL DQALLOCATE 

MOV ARRAYBASE, AX ; returned value 


This example Is applicable to programs assembled according to the COMPACT, 
MEDIUM, and LARGE models of segmentation. For the SMALL model, you would 
not push the segment register before each parameter. 
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DQSAITACH 


The DQ$ATTACH system call creates a connection to an existing file. 


connection = DQ$ATTACH (path$ptr, except$ptr); 


INPUT PARAMETER 

path$ptr A POINTER to a STRING containing the pathname for the 

file to be attached. 


OUTPUT PARAMETERS 

connection A WORD in which the iRMX 86 Operating System will 
place the CONNECTION to the file. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call allows a program to obtain a connection to any file. 
Attaching a file that is already attached is valid. A connection to the 
existing file is made, and all prior connections remain established. 

It is not a valid operation to attach :C0: or :LP:; if you do so the 
Operating System will return the exception code E$SUPPORT. 
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DQ$CHANGE$EXTENSION changes or adds the extension at the end of a file 
name* 


CALL DQ$CHANGE$EXTENSION (path$ptr, extension$ptr, except$ptr); 



INPUT PARAMETERS 

path$ptr A POINTER to a STRING that specifies the path for the 

file to be renamed. 

extension$ptr A POINTER to a series of three bytes containing the 

characters that are to be added to the pathname. This 
is not a STRING. You must include three bytes, even 
if some are blank. 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call is used to change a file name extension, or add an 
extension. For example: :AFD1: FILE. SRC can be changed to :AFD1: FILE. OBJ 
by a compiler when the compiler creates a file in which the object file 
is written. 

The three character extension may not contain delimiters recognized by 
DQ$GET$ARGUMENT but may contain trailing blanks. If the first character 
addressed by extension$ptr is a space, the system call will delete any 
prior extension (Including the preceding period). 
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DQSCLOSE 


DQ$CLOSE waits for completion of I/O operations taking place on the file 
(if any), empties output buffers, and frees any buffers associated with 
the CONNECTION. 


CALL DQ$CLOSE (connection, except$ptr); 


INPUT PARAMETER 

connection A WORD containing a token for a file CONNECTION that 
is currently open. 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

The DQ$CLOSE system call closes a connection that has been opened by the 
DQ$OPEN system call. It performs the following steps: 

1. It waits until all currently running I/O operations for the file 
are completed. 

2. It ensures that any information in a partially filled output 
buffer is written to the file. 

3. It releases any buffers associated with the file. 

4. It closes the connection to the file. Ihe connection is stil 
valid, and can be re-opened if necessary. 



Access Control 

The Operating System performs no access checking before closing the 
connection. 
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DQSCRFATE 


DQ$CR£ATE creates a new file and establishes a connection to that file. 


connection = DQ$CREATE (path$ptr, except$ptr); 


INPUT PARAMETER 

path$ptr A POINTER to a STRING that specifies the path of the 

file to be created. 



OUTPUT PARAMETERS 

connection A WORD In which the Operating System places a 
CONNECTION to the newly created file. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described In 
Appendix A. 


DESCRIPTION 


This call creates a new file with the name you specify and returns the 
CONNECTION to your program. If a file of the same name already exists It 
Is truncated (the data is destroyed). 

To prevent accidentally destroying a file, issue DQ$ATTACH before Issuing 
DQ$CREATE. If the file does not exist, you receive an exception code of 
E$FNEXIST upon return from DQ$ATTACH. 
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DQ$DECODE$EXCEPTION translates an exception code Into an ASCII string. 


CALL DQ$DECODE$EXCEPTION (except$code, buff$ptr, except$ptr); 


INPUT PARAMETER 

except$code A WORD that contains the numeric exception code that 
Is to be Interpreted. 


OUTPUT PARAMETERS 

buff$ptr A POINTER to a buffer (at least 81 bytes long) In 

which the system will return a STRING. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described In 
Appendix A. 


DESCRIPTION 

Your program provides the Operating System with the numeric value of an 
exception code, and the IRMX 86 Operating System returns the mnemonic and 
hex value of this code. For example. If you pass DQ$DECODE$EXCEPTION a 
value of 2 In except$code, the system will return the following string: 

0002: E$MEM 

The hex values and mnemonics for exception codes are listed In Appendix A. 
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DQ$DELETE eliminates an existing file 


CALL DQ$DELETE (path$ptr, except$ptr); 


INPUT PARAMETER 

path$ptr A POINTER to a STRING that specifies the pathname of 

the file to be deleted. 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

A program can use this system call to delete a file. This system call 
will mark for deletion the specified file. This means that the system 
may actually postpone deletion if there are other connections to the file 
and delete the file only when all connections are closed and detached. 




DQSDETACH 


DQ$DETACH breaks the connection established by DQ$ATTACH or DQ$CREATE. 


CALL DQ$DETACH (connection, except $ptr); 


INPUT PARAMETER 

connection A WORD containing a token for the file CONNECTION to 
be deleted. 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call deletes a file CONNECTION. If the CONNECTION is open, 
the DQ$DETACH system call automatically closes it first (see DQ$CLOSE). 
DQ$DETACH will also delete the file if it has been marked for deletion 
and this is the last CONNECTION to the file. 
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I)Q$EXIT 


DQ$EXIT returns control from your program to the Operating System. 


CALL DQ$EXIT (end$code); 


INPUT PARAMETERS 

end$code A WORD containing the encoded reason for termination 

of the program. You must include this code, but 
currently the IRMX 86 Operating System does not check 
The standard codes are: 

INTERPRETATION 


Termination was normal. 
Warning messages were Issued. 
Errors were detected. 

Fatal errors were detected. 
The job was aborted. 


DESCRIPTION 


this value. 

VALUE 

0 

1 

2 

3 

4 


DQ$EXIT terminates a program. All connections are detached, all files 
are closed, and any memory allocated to the program with DQ$ALLOCATE is 
returned to the memory pool. 

Calling DQ$EXIT cannot result In an exception code. 
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DQ$FREE returns to the Operating System a segment of memory acquired 
earlier by DQ$ALLOCATE. 


CALL DQ$FREE (base$addr, except$ptr); 


INPUT PARAMETER 

base$addr A SELECTOR containing the base address of the segment 

that Is to be deleted. This Is the base address 
SELECTOR returned to your program by DQ$ALLOCATE. 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described In 
Appendix A. 


DESCRIPTION 

The DQ$FREE system call returns the specified segment to the memory pool 
from which It wks allocated. 
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DQ$GET$ARGUMENT 


The DQ$GET$ARGUMENT system call is used to return successive arguments 
from a command line. 


delimit$char = DQ$GET$ ARGUMENT (argument$ptr, except$ptr); 


INPUT PARAMETER 

argument$ptr A POINTER to a buffer in which the system will return 
the argument string. The length of the string (in 
bytes) is stored in the first byte of this area. The 
buffer must be at least 81 bytes long. 


OUTPUT PARAMETERS 

delimit$char This is a single BYTE in which the system returns the 
delimiter character. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

GET$ARGUMENT is called to get successive arguments from a command line. 
The command line may be the same one that invoked the program containing 
this call. But if the UDI system call DQ$SWITCH$BUFFER is called before 
DQ$GET$ARGUMENT, the command line can be anywhere that you specify. 

A delimiter is returned only if the exception code is zero. The 
following delimiters are recognized by the iRMX 86 Operating System: 

,)(=#!$% \+-><- 

as well as a space ( ), the grave accent (^), and any characters with 
hexadecimal values between 0 and 20H. 

The Operating System will strip out ampersands (&) and semi-colons (;). 
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DQ$GET$ARGUMENT 


Before your program runs, the Operating System Command Line Interpreter 
(CLI) pre-edits the command line to remove comments and continuation 
characters. The Operating System also makes the following changes to the 
command line: 

• Multiple adjacent blanks separating two arguments are treated as 
one blank. One or more blanks adjacent to any other delimiter 
are removed. A tab is treated as a blank and returned as a blank. 

• Lower case characters are converted to upper case unless part of 
a quoted string. 

• Strings enclosed within a matching pair of single or double 
quotes are considered literals. The enclosing quotes are not 
returned as part of the argument. 


EXAMPLE 

The following example illustrates the arguments and delimiters 
returned by successive calls to DQ$GET$ARGUMENT. The ARGUMENT LENGTH 
value is in the first byte of the string returned, the contents of each 
string is listed in the column ARGUMENT VALUE, and the delimiter returned 
in the byte delimit$char is in the column DELIMITER. 

Note that the last delimiter for each example is a carriage return (CR); 
this is how a program determines that there are no more arguments in the 
command line. 



Table 4-2. Command Parsing Example 


PLM86 LINKER. PLM PR1NT(:LP:) NOLIST 


ARGUMENT 

LENGTH VALUE 

DELIMITER 

8 

PLM86 

(space) 

10 

LINKER. PLM 

(space) 

5 

PRINT 

( 

4 

;LP: 

) 

6 

NOLIST 

CR 
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DQSGETSCONNFXTIONSSTATUS 


The DQ$GET$CONNECTION$STATUS system call returns Information about a file. 


CALL DQ$GET$CONNECTION$ STATUS (connection, info$ptr, except$ptr); 


INPUT PARAMETER 

connection A WORD containing a token for the CONNECTION whose 
status is desired. 



OUTPUT PARAMETERS 

info$ptr A POINTER to a structure in which the Operating System 

will place the status Information. The structure of 
lnfo$ptr should be: 

DECLARE INFO STRUCTURE 


(OPEN 

BYTE, 

ACCESS 

BYTE, 

SEEK 

BYTE, 

FILE$PTR$LOW 

WORD, 

FILE$PTR$HIGH 

WORD) ; 


These fields are Interpreted as follows: 

OPEN 1 if connection is open, otherwise 2. 

ACCESS Access privileges of the connection. The 

right is granted if the corresponding bit is 
set. 


BIT ACCESS 

0 delete 

1 read 

2 write 

3 update (read and write) 
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DQ$GET$CONNECTION$STATUS 


info$ptr (continued) 

SEEK Types of seek supported. 

VALUE MEANING 

0 no seek allowed 

3 seek forward and backward 


Values of 1 and 2 are not meaningful to the 
iRMX 86 Operating System. 


FILE$PTR$HIGH These two items together form a 4-byte unsigned 
FILE$PTR$LOW integer that indicates the current position in 
the file. The position is expressed as the 
number of bytes from the beginning of the 
file, the first byte being byte 0 (zero). 

This field is undefined if the file is not 
open or if backward seek is not supported by 
the device (for example, the printer cannot be 
rewound). 


except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

DQ$GET$CONNECTION$STATUS is used to obtain information about a file 
CONNECTION. For example, you can use the system call if your program has 
performed a number of read or write operations and it is necessary to 
determine where the file pointer is now located. 
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DQ$GET$EXCEPTION$HANDLER returns the address of the current exception 
handler. 


CALL DQ$GET$EXCEPTION (address$ptr, except$ptr); 



OUTPUT PARAMETERS 


address$ptr A POINTER to a four-byte area that the Operating 

System fills with a long pointer to the entry point of 
the current exception handler. A long pointer has the 
form; 


DECLARE LONG$P STRUCTURE 
(LONG$OFFSET WORD, 

LONG$BASE WORD); 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

DQ$GET$EXCEPTION$ HANDLER Is an informative system call that returns to 
your program the address of the current exception handler. This is the 
address specified in the last call to DQ$TRAP$EXCEPTION, if it has been 
called, otherwise the value returned is the address of the system default 
exception handler. 

This routine always returns a four-byte pointer, even if called from a 
program compiled under the SMALL model of segmentation. 

DQ$GET$EXCEPTION$HANDLER is used in conjunction with DQ$TRAP$EXCEPTION 
and DQ$DECODE$EXCEPTION. See the descriptions of these calls for more 
information. 
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DQ$GET$SIZE 


DQ$GET$SIZE returns the size of an allocated memory segment. 


size = DQ$GET$SIZE (base$addr, except$ptr); 


INPUT PARAMETER 

base$addr A SELECTOR containing the base address of a block of 

memory that was allocated with the DQ$ALLOCATE call. 
This is the same address that is returned by 
DQ$ALLOCATE when the segment was allocated. 


OUTPUT PARAMETERS 

size A WORD which the Operating System sets as follows: 

• if not zero, contains the size, in bytes, of the 
segment identified by the base$addr parameter 

# if zero, indicates that the size of the segment 
is 65536 (64K) bytes. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

The GET$SIZE system call returns the size, in bytes, of a segment. You 
identify the segment of memory with a base address SELECTOR that is 
returned by the DQ$ALLOCATE system call when the segment is allocated. 

The size of the segment may not be exactly what you requested with the 
DQ$ALLOCATE call. The Operating System allocates memory in 16-byte 
paragraphs . If you request a segment whose size is not a multiple of 16, 
the system increases the size to the next 16-byte boundary. This larger 
size is reflected in the size returned by DQ$GET$SIZE. 
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SYSTEM CALLS 




DQSGETSSYSTEMSID 


DQ$C£T$SYS'IXM$ID returns a string that identifies the operatic^ system. 


CALL D^G1*E$SYSTQ!$ID (id$ptr, exeept$ptr>; 


OUTPUT PARAMETERS 

ld$ptr POINTER to a 21-hyte buffer in which the Operating 

System will place a STRING identifying the Operating 
System. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call returns the following STRING: 
IRMX 86 
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DQSGETSTIMK 


DQ$^T$TIME returns the current date and time in character format. 


CALL D<^GET$TIME (huff$ptr, except$ptr); 


ODTPOT PARAJBSIERS 

buff$ptr A POISTER to a buffer In which the Operatii^ System 

returns the current date and time. The structure of 
the buffer should be: 

DECLARE DT STROCTDRE 

(DATE (8) BYTE, 

TIME (8) BYTE); 


except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call returns the current date and time, each as a series of 
bytes. DATE has the form MM/DD/YY for month, day, and year. The two 
slashes (/) are in the third and sixth bytes. For example, the date 
January 15th of 1982 would be returned as: 

01/15/82 

TIME has the form HH:MM:SS for hours, minutes, and seconds, with 
separating colons (:). The value for hours ranges from 0 through 23. 
For example, the time 20 seconds past 3:12 PM would be returned as: 

15:12:20 
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SYSTKM CALLS 



The DQ$OPEN system call Is used to inform the Operating System how your 
program is going to access a file, and to Identify the buffers you will 
use. 


CALL DQ$OPEN (connection, access, num$buf, except$ptr); 


INPUT PARAMETERS 


connection 


access 


num$buf 


A WORD containing a token for the file CONNECTION to 
be opened. 


A BYTE telling how your program is going to use the 
CONNECTION. You should set the BYTE as follows: 


Value 


Meaning 


1 Read only 

2 Write only 

3 Update (both reading and writing) 


A BYTE containing the number of buffers that you want 
the Operating System to allocate for this connection. 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call prepares a connection for read, write, and seek 
commands. Your program can have up to twenty connections open at one 
time, if there is sufficient memory. 
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DQ$OPEN 


DESCRIPTION (continued) 

DQ$OPEN: 

!• Creates the number of buffers requested. 

2. Sets the connection’s file pointer to zero. This is the pointer 
that tells the Operating System where in the file to perform an 
operation. 

3. Starts reading ahead if num$buf is greater than zero and the 
access parameter is "Read only” or "Update. ” 


Selecting Access Rights 

The system will not allow your program to read using a connection open 
for writing only, nor to write using a connection open for reading only. 
If you are not certain how the connection will be used, specify both 
reading and writing. 


Selecting the Number of Buffers 

The process of deciding how many buffers to allocate is based on three 
considerations — compatibility, memory, and performance. 



COMPATIBILITY . If you expect to run your program on other systems using 
UDI, you should use no more than two buffers. 

MEMORY . The amount of memory used for buffers is directly proportional 
to the number of buffers. So you can save memory by using fewer buffers. 


PERFORMANCE . The performance consideration is more complex. Up to a 
certain point, the more buffers you allocate, the faster your program can 
run. The actual break-even point, the point where more buffers don’t 
improve performance, depends on many variables. Be aware that in order 
to overlap I/O with computation, you must specify at least two buffers. 

If performance is not at all important and memory is, use zero buffers. 

Specifying zero buffers means that no buffering should occur; each 
DQ$READ or DQ$WRITE should result in a physical I/O operation. 

Interactive programs should open :CI: and :C0: with num$buf set to zero 
to eliminate buffering. 

If you normally seek before doing a read or write, num$buf should be 1. 
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SYSI 


ERLA\ 


Hie IIQ$01f£HAY system call is invoked by a root module to load an overlay 
mmiule* 


CALL DQ$0¥E1LAY (name$ptr, except$ptr); 


INPUT PARAMETER 

name$ptr A POINTER to a STRING that contains the name of an 

overlay module. The name must be in upper-case. 



OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call is invoked by a root module whenever the root module 
wishes to load an overlay module. 

If your assembly language or PL/M-86 programs use the DQ$OVERLAY 
procedure, you should take care to ensure that you link the UDI library 
to your program correctly. The lAPX 86, 88 FAMILY UTILITIES USER^S GUIDE 
contains an example of linking an overlay program. This example lists a 
two-step link process, as follows: 


1. Link the root and each of the overlays separately, specifying the 
OVERLAY control, but not the BIND control, in each LINK86 command. 

2. Link all the output modules together in one module, specifying 
the BIND control, but not the OVERLAY control. 

This is the same process that you should use when linking your iRMX 86 
overlay programs. However, you must ensure that you link the entire UDI 
library to the root portion of the program and not to any of the 
overlays. To do this, use the INCLUDE control to Include the UDI 
externals file (SYSTEM/UDI/UDI.EXT) with the assembly or compilation of 
the root portion of the program. By including this file with the root, 
you make external references to all UDI routines from that root. Then 
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DQ$OVERLAY 


DESCRIPTION (continued) 

when you link the root to the DDI library, LINK86 pulls in all of the UDI 
routines, not just the ones called in the root. Since you are linking 
the UDI library to the root only, this prevents you from having 
unsatisfied external references when you link the root to the overlays. 

For exanqile, suppose your program consists of three files, ROOT. OBJ, 
OVIA.OBJ, and 0V2A.0BJ, the root and overlay files, respectively. You 
have conq>iled these program modules with the PL/H-86 compiler and 
Included the UDI externals file DDI. EXT with the compilation of the 
root. Assuming that L1NK86 resides on the default logical device in the 
default directory, and that the object files reside in the directory 
PROG, the following LINK86 commands will link the overlay program and 
produce an executable module. This happens in two steps. 

1. The first three L1NK86 commands separately link the root and 
overlay portions of the program. The root portion of the program 
is linked to the UDI library (underlined entries are your 
commands). 

-LINK86 PROG/ROOT. OBJ, & 

* *SYSTEM/UDI/URXLRG.LIB OVERLAY 

IRMX 86 8086 LINKER Vx.y 

-LINK86 PROG/OVIA.OBJ OVERLAY(OVERLAYl) 

iRMX 86 8086 LINKER Vx.y 

-LINK86 PR0G/0V2A.0BJ 0VERLAY( OVERLAY 2) 

2. The next L1NK86 command links together in one module all the 
output modules produced in the first step. 

-LINK86 PROG/ROOT. LNK, & 

**PR0G/0V1A.LNK, & 

**PR0G/0V2A.LNK & 

**T0 PROGRAMl BIND MEMPOOL(+20OOH) 
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The DQ$READ moves a ntmiber of bytes from a file to a buffer. Your 
calling program must specify the connection, the number of bytes, and the 
buffer to receive the information. 


bytes$read = DQ$READ (connection, buff$ptr, bytes$max, 

except $ptr); 


IKTUT PARAMETERS 

connection A WORD containing a token for the connection to the 

file. This connection must be open for reading or for 
both reading and writing, and the file pointer of the 
connection must point to the first byte to be read. 

buff$ptr A POINTER to a buffer that will receive the data that 

the Operating System reads from the file. 

bytes$max A WORD containing the maximum number of bytes you 

expect to read from the file. 


OUTPUT PARAMETERS 

bytes$read A WORD containing the actual number of bytes read. 

This number is always equal to or less than the 
bytes$max. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call reads a collection of contiguous bytes from the file 
associated with the connection. These bytes are placed in a buffer 
specified by the calling program. 
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DQSiREAD 


DESCRIPTION (continued) 

The Buffer 

The buff$ptr parameter tells the Operating System where to place the 
bytes after they are read. This is a buffer you create, and if it is not 
long enough, the Operating System overwrites the area beyond the buffer. 


Number of Bytes Read 

The number of bytes that your program requests is the maximum number of 
bytes that the Operating System places in the buffer. However, there are 
two circumstances under which the system reads fewer bytes. 

• First, if the Operating System detects an end of file before 
reading the ntimber of bytes requested, it will return only those 
bytes preceding the end of file. The bytes$read parameter can be 
less than the bytes$deslred parameter, and no exceptional 
condition will be indicated. 

• Second, if an exceptional condition does occur during the reading 
operation, information in the buffer and the value of the 
bytes$read parameter are meaningless. 



Access Control 

If the connection is not opened for reading or both reading and writing, 
the Operating System returns an exceptional condition. 
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The DQ$RENAME system call changes the pathname of a file. 


CALL DQ$RENAME (path$ptr, new$path$ptr, except$ptr); 


INPUT PARAMETERS 

path$ptr A POINTER to a STRING that specifies the pathname for 

the file to be renamed. 

new$path$ptr A POINTER to a STRING that specifies the new path for 
the file. This path cannot refer to an existing file. 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call allows your programs to change the pathname for a file 
or a directory. Be aware that when you rename a directory, you are 
changing the pathnames of all files contained in the directory. When you 
rename a file to which a connection exists (this is valid) the connection 
to the renamed file remains established. 

Your program can change any aspect of the pathname so long as the file or 
directory remains on the same volume. 
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DQSSEEK 


DQ$SEEK changes the file position pointer. 



INPUT PARAMETERS 

connection A WORD containing a token for an open connection whose 
file pointer you wish to move. 

hi$move$count These two WORDS combine to form a 32-bit integer 

lo$move$count that tells the Operating System how many bytes to move 
the file pointer. 

mode A BYTE containing a value that controls the nature of 

the movement of the file pointer. Any of the 
following values are valid: 

Mode Meaning 

1 Move the pointer backward by the specified 
move count. If the move count is large enough 
to position the pointer past the beginning of 
the file, set the pointer to the first byte 
(position zero). 

2 Set the pointer to the position specified by 
the move count. Position zero is the first 
position in the file. Moving the pointer 
beyond the end of the file is valid. 

3 Move the file pointer forward by the specified 
move count . Moving the pointer beyond the end 
of file is valid. 

4 First move the pointer to the end of the file 
and then move it backward by the specified 
move count. If the specified move count would 
position the pointer beyond the front of the 
file, set the pointer to the first byte in the 
file (position zero). 
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SYSTEM CALLS 


DQSSEEK 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

When performing random I/O, your programs must use this system call to 
position the file pointer before using the DQ$READ, DQ$TRUNCATE, or 
DQ$WRITE system calls. The location of the file pointer tells the 
Operating System where in the file to begin reading, truncating, or 
writing information. If your program is performing sequential I/O on a 
file, they do not need to use this system call. 

As mentioned previously, it is legitimate to position the file pointer 
beyond the end of file. If your program does this and then invokes the 
DQ$READ system call, the Operating System behaves as though the read 
operation began at the end of file. 

Also, it is possible to invoke the DQ$WRITE system call with the file 
pointer beyond the end of the file. If your program does this, the 
Operating System attempts to expand the file. Be aware that if you 
expand your file in this manner, the expanded portion of the file will 
contain undefined information. 
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DQSSPECIAL 


DQ$SPECIAL specifies whether line editing is to be performed by the 
Operating System on console input. 


CALL DQ$SPECIAL (mode, conn$ptr, except$ptr); 


INPUT PARAMETERS 

mode A BYTE used to change the mode of terminal input. The 

values are: 

• Transparent 1 

• Line editing (default) 

• Transparent 3 

Each of these types is explained in the description. 

conn$ptr A POINTER to a token for the CONNECTION to the file. 

The CONNECTION must be a connection to :CI: 
established by DQ$ATTACH. 



OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call is used to change the technique by which your program 
receives input from a console input device. The default mode is line 
editing, but by using DQ$SPECIAL you can change from line editing to one 
of the transparent modes, or back to line editing. 

The meanings of the type parameter are as follows. 
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DQSSPEGIAL 



DESCRIPTION (continued) 


Value Meaning 


1 Transparent 1 « Interactive programs often need to obtain 

characters from the console exactly as they are typed. 

This is made possible by transparent mode. In transparent 
mode, all characters are placed in the buffer specified by 
the call to DQ$READ. (The only exception are CTRL/C, 
which will terminate the program, and CTRL/D, which has no 
effect on the system. ) The Operating System returns 
control to the calling program when the number of 
characters typed equals the number of characters specified 
in the DQ$READ system call. 

1 2 Line editing . This means that the console operator has 

the opportunity to correct typing errors. Data from the 
console is not actually returned by a call to DQ$READ 
until the operator types a carriage return. The Operating 
System removes editing characters (such as the backspace ) 
from the input, and also adds a line feed to the final 
carriage return if buffer space permits. 

3 Transparent 3. This is nearly the same as Transparent 1 

mode, except that in Tranparent 3 mode the Operating 
System returns control to your program immediately after 
the DQ$READ call, whether or not any characters have 
actually been typed since the last DQ$READ. If no 
characters have been typed, this will be indicated by the 
bytes$read parameter of the DQ$READ call. Characters that 
are typed between successive calls to read the terminal 
are held in a special Operating System buffer called the 
"type-ahead” buffer. 
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DQ$SWITCH$BUFFER is used with DQ$GET$ ARGUMENT to get arguments from a 
command line contained within your program. 


offset = DQ$SWITCH$BUFFER (buff$ptr. 



INPUT PARAMETERS 

buff$ptr A POINTER to a STRING containing the text to be parsed. 


OUTPUT PARAMETERS 

offset A WORD that the Operating System sets equal to the 

number of bytes from the beginning of the buffer to 
first character in the next argtment in the buffer. 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

DQ$SWITCH$ BUFFER is used to point to a command line other than the line 
that invoked this program. Typically, you will first call 
DQ$SWITCH$BUFFER, and then make a series of calls to DQ$GET$ARGUMENT. 

Each call to DQ$GET$ARGUMENT fetchs an argument from the line pointed to 
by buff$ptr. 

DQ$SWITCH$BUFFER can also be used as an informative system call if you 
need to know the location of the next argument in the line. If you call 
DQ$SWITCH$BUFFER without changing buff$ptr, the value returned in offset 
is the number of bytes from the beginning of the command line to the 
first character in the next argument. 

The parameter offset will be zero (0) upon return from the first call to 
DQ$SWITCH$BUFFER. 
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SYSTEMCALLS 


TRjYmAPSEXCEPTlON 


DQ$TRAP$EXCEPTION substitutes an alternate exception handler for the 
default exception handler provided by the operating system. 



INPUT PARAMETERS 

address$ptr the address of a four-byte area containing a long 

pointer to the entry point of the alternate exception 
handler. A long pointer has the form: 

DECLARE LONG$P STRUCTURE 
(LONG$OFFSET WORD, 

LONG$BASE WORD); 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

DQ$TRAP$EXCEPTION is used to inform the Operating System that when an 
exceptional condition occurs, the Operating System is to pass control to 
your exception handler. An exceptional condition is defined as a return 
from a system call with a condition code other than E$OK (see Appendix A 
for exception code meanings). 

See the section EXCEPTION-HANDLING SYSTEM CALLS at the beginning of this 
chapter for an explanation of the conditions of the stack when your 
exception handler receives control. 
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DQ$TRUNCATE 


DQ$TRUNCATE removes information from the position of the file pointer to 
the end of the file. 


CALL DQ$TRUNCATE (connection, except$ptr); 


INPUT PARAMETER 

connection A WORD containing a token for a CONNECTION to the 
named data file that is to be truncated. The file 
pointer of this CONNECTION tells the Operating System 
where to truncate the file. The BYTE indicated by the 
pointer is the first byte to be dropped from the file. 


OUTPUT PARAMETER 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call truncates a file at the current setting of the file 
pointer and frees all space beyond the pointer. If the pointer is at or 
beyond the end of file, no truncation will be performed. Unless the file 
pointer is already where you want it, your program should use the DQ$SEEK 
system call to position the pointer before using the DQ$TRUNCATE system 
call. 

The CONNECTION should have write, or read and write access rights, 
established when the connection is opened. 
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DQ$WRITE 


The DQ$WRITE system call moves a collection of bytes from a buffer Into a 
file. 


CALL DQ$WRITE (connection, buff$ptr, count, except$ptr; 



INPUT PARAMETERS 


connection A WORD containing a token for the CONNECTION to the 
file in which the information is to be written. 


buff$ptr A POINTER to a collection of contiguous bytes that are 

to be written to the specified file. 

count A WORD containing the number of bytes to be written 

from the buffer to the file. 


OUTPUT PARAMETERS 

except$ptr A POINTER to a WORD where the system places the 

condition code. Condition codes are described in 
Appendix A. 


DESCRIPTION 

This system call causes the Operating System to write the specified 
number of bytes from the buffer to the file. 


Access Control 

In order to write information into a file. The file must be open for 
writing, or for reading and writing ( update access ). Whenever your 
program attempts to write over Information in a file via a connection 
that does not have update access, the Operating System does not write any 
data to the file but returns an exception code. The description of 
DQ$OPEN explains how access is established. 
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DQ$WRITE 


DESCRIPTION (continued) 

Number of Bytes Written 

Occasionally, the Operating System writes fewer bytes than requested by 
the calling program. This happens under two circtimstances. The first 
circumstance is when the Operating System encounters an I/O error (E$IO 
exception code is returned). 

The second circumstance is when the volume to which your program is 
writing becomes full. Ihe Operating System informs your program of this 
condition by returning an E$SPACE exception code. 


Where the Bytes Are Written 

The Operating System writes the bytes starting at the location specified 
by the connection's file pointer. (The pointer indicates where the first 
byte is to be written.) The pointer is updated as the bytes are 
written. After the writing operation is completed, the file pointer 
points to the byte immediately following the last byte written. 

If your program must reposition the file pointer before writing, it can 
do so by using the DQ$SEEK system call. 
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SYSTEM CALLS 


UDI SYSTEM CALLS 


EXAMPLE PROGRAM 

This program provides an example of UDI system calls. 


$compact 

$optlmize(3) 



* Program UPPER 

* 

* This program demonstrates the use of UDI file handling: 

* and command line parsing system calls. The program reads an input 

* file of characters, and converts all lower-case alphabetic 

* characters to upper-case. The converted date is written to a 

* second file. 

ic 

* UPPER expects the command line that invokes it to be of the form: 

* 

* UPPER infile [TO outfile] 

* 

* (If **T0 outfile” is not specified, :C0: is assumed.) 



upper: DO; 

$include(system/udi/udi.ext) /* This file is described at the beginning 

of the chapter */ 


DECLARE 

CR LITERALLY 'ODH', 

LF LITERALLY ’OAH», 

E$OK LITERALLY 'O’; 


DECLARE 

co$conn WORD; 
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EXAMPLE PROGRAM (continued) 


$subtitle( ’check$exception' ) 

/* 

* Procedure to check an exception code. If the exception code is 

* not E$OK, print a message and exit. 

* 

*/ 


check$exception: PROCEDURE(exception, info$p) REENTRANT; 

DECLARE 

exception WORD, 
info$p POINTER, 

info BASED lnfo$p STRUCTURE ( 

count BYTE, 

char(l) BYTE), 

exc$buf STRUCTURE( 

count BYTE, 

char(80) BYTE), 
dummy WORD ; 


IF exception <> E$OK THEN 
DO; 

CALL dq$decode$exceptlon(exceptlon, @exc$buf, Qdummy); 

CALL dq$write(co$conn, 0exc$buf .char, exc$buf .count, 
@dummy); 

CALL dq$write(co$conn, @( V: '), 2, 0dummy); 

CALL dq$write(co$conn, @info.char, info. count, @dummy); 
CALL dq$write(co$conn, @(CR, LF), 2, @dummy); 


CALL dq$exit(3); 

END; 


END check$exception; 
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UDI SYSTEM CALLS 


EXAMPLE PRO@AM (continued) 


$8ubtltle( *Main* ) 

/* 

* 


* 

* 


*/ 


MAIN PROGRAM — 



DECLARE St WORD; 


DECLARE 

in$name(50) BYTE, 
out$name(50) BYTE, 
ln$conn WORD, 
out$conn WORD, 
delim BYTE; 


DECLARE 

buffer(1024) 

ln$bp 

ln$char 

next char 

ln$count 

n$wrlte 

1 


BYTE, 

POINTER, 

BASED in$bp BYTE, 
BASED ln$bp (2) BYTE, 
WORD, 

WORD, 

WORD; 


/* 

* Create a connection to :CO: (console output) 

* 

*/ 

co$conn =« dq$create(@(4, ’:CO:'), @st); 

CALL dq$open(co$conn, 2, 0, @st); 

/* 

* Ignore the name of the program 

* 

*/ 

delim = dq$get$argument(@buffer, @st); 

CALL check$exception(st, 0); 

IF delim = CR THEN 

CALL dq$exit(0); 
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EXAMPLE PROGRAM (continued) 


/* 

* Attach the input file, and open it. 

* 

*/ 

delim = dq$get$argument(@in$name, @st); 

CALL check$exception(st, 0); 

in$conn = dq$attach(0in$name, @st); 

CALL check$exception(st, @in$name); 

CALL dq$open(in$conn, 1, 2, @st); 

CALL check$exception(st, @in$name); 

/* 

* Make ready the output file 

* 

*/ 

IF delim <> CR THEN 
DO; 

delim = dq$get$argument(@buf fer, @st); 

CALL check$exception(st, 0); 

IF (delim = CR) OR 

(buffer(O) <> 2) OR 
(buffer(l) <> 'T') OR 
(buffer(2) <> ’O’) THEN 
DO; 

CALL dq$write(co$conn, @( 'Invalid output file’, 
CR, LF), 21, @st); 

CALL dq$exit(3); 

END; 

delim = dq$get$argument(@out$name, @st); 

CALL check$exception(st, 0); 

out$conn = dq$create(@out$name, @st); 

CALL check$exception(st, @out$name); 

CALL dq$open(out$conn, 2, 2, @st); 

CALL check$exception(st, @out$name); 

END; 

ELSE 

out$conn = co$conn; 
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UDI SYSTEM CALLS 


EXAMPLE PROGRAM (continued) 


/* 

* Read from input, convert, and write to output 

* 

*/ 

DO WHILE 1; 

in$count = dq$read(in$conn, ©buffer, size(buffer), @st); 
CALL check$exception(st, ©in$name); 

IF in$count = 0 THEN 
GOTO end$of$file; 

DO i=0 TO in$count-l; 

IF (buffer(i) >= ’a’) AND (buffer(i) <= 'z') THEN 
buffer(i) * buffer(i) + 'A'-’a'; 

END; 

CALL dq$write(out$conn, ©buffer, in$count, @st); 

CALL check$exception(st, ©out$name); 

END; 

end$of$f ile: 

/* 

* Close input and output files and exit 

* 

*/ 

CALL dq$close(in$conn, ©st); 

CALL check$exception(st, ©in$name); 

CALL dq$close(out$conn, ©st); 

CALL check$exception(st, ©out$name); 

CALL dq$exit(0); 


END upper; 


CHAPTER 5. PREPARING YOUR HARDWARE 


This chapter describes how to prepare the hardware devices on which the 
iRMX 86 PC Operating System runs, (see Figure 5-1). The iRMX 86 PC 
product is a version of the iRMX 86 Operating System that has been 
prepared by Intel to run in the hardware environment described here. 
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This chapter is organized as follows r 

m THE ima 86 PC HARMARE ENVIRONMENT , A section describing 
hardware on which the iRMX 86 PC will run. 

• MOMFYING BOARDS . A section describing how to modify your 
iAPX 86~based Single Board Computer, and how to modify the 
iSBC 208 Disk Controller board. 

• CONVENIENCE CHARTS . To make the process of preparing your 
hardware easier, we have included (for each board described in 
this chapter) a single-page condensed summary of modifications 
required for that board. This is so that you can remove the page 
and refer to it as you actually install required jumpers and 
devices. These charts are the last four pages (two physical 
pages) in this chapter. 


THE iRMX 86 PC HARDWARE ENVIRONMENT 

The IRMX 86 PC Operating System runs on the following hardware 
components (shown in Figure 5-1): 

• An Intel iSBC 86 processor board. 

• An ISBC 208 Flexible Disk Drive Controller with at least two 
drives (you can connect as many as four drives). 

• A video terminal connected to the computer board serial port. 

The software assumes that this terminal is RS232C-compatlble, and 
set to 9600 baud full-duplex, with no parity checking (the 
computer ignores parity from the terminal, and sets the parity 
bit to zero (0) on data to the terminal. 

• An appropriate chassis/power-supply unit with a 
Multibus-compatible backplane. 

In addition, you can also have either a line printer or an iSBC 957B 
package (they both use the same parallel port on the computer board). 

The iSBC 957B package allows you to connect your system directly to an 
Intellec Microcomputer Development System. Neither the line printer nor 
the ISBC 957B package is required to run the Operating System. 


SINGLE BOARD COMPUTER 

The IRMX 86 PC Operating System runs on any of these Single Board 
Computers: iSBC 86/12A, iSBC 86/14, or iSBC 86/30. 
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PREPARING YOUR HARDWARE 


FLEXIBLE DISKETTE CONTROLLER AND DRIVES 

The iSBC 208 Controller will handle up to four drives. Two drives are 
required to run the iRMX 86 PC System. The iSBC 208 Controller will 
accept drives and diskettes of many recording formats: single- and 
double-density, single- and double-sided, and sector sizes of 128, 256, 
and 1024 bytes. The diskettes are soft-sectored , which means that you 
must format new diskettes using the FORMAT command described in 
Chapter 3. The iRMX 86 PC System is delivered on double-density, 
single-sided diskettes having 256 bytes-per-sector . 

Physical names that must be used with the iSBC 208 Controller for various 
disk characteristics and drives are listed in Table 5-1. Although only 
drive number 0 is listed for each type, the controller and the iRMX 86 PC 
Operating System support up to four drives (for example, AFDO, AFDl, 

AFD2, and AFD3). You specify these names when using the iRMX 86 PC 
Command ATTACHDEVICE described in Chapter 3. 

Table 5-1. iSBC® 208 Physical Names 


Device 

Names 

Device 

Type 

Sides 

Density 

Bytes per 
Sector 

AFO 

208 Shugart SA800 

1 

Single 

128 

AFDO 

208 Shugart SA800 

1 

Double 

256 

AFDDO 

208 Shugart SA850 

2 

Double 

256 

AFDXO 

208 Shugart SA850 

2 

Double 

1024 


MEMORY 

The iRMX 86 PC Operating System requires at least 192K bytes of memory to 
run. In addition, you will need memory sufficient to run your programs, 
system utilities, and language processors. Some memory is on-board the 
iSBC 86 Single Board Computer, with the remainder on one or more memory 
boards. On-board memory may include a RAM expansion module ; with a RAM 
expansion module the iSBC 86/30 has enough memory to run the Operating 
System. 


LINE PRINTER 

You can use any line printer that recognizes the Centronics signal/pin 
standard. The line printer is connected to the parallel port on the 
processor board you use. 


5-3 














PREPARING YOUR HARDWARE 


Table 5~2 shows the signals that are present on pins at the: 

• 50-Pin iSBC Connector : The Single Board Computer parallel port 

connector (Jl). 

• 50-Pin Edge Connector : A standard 50-pin edge connector used as 

a cable-end; mates to the iSBC Connector described in 1. 

• 30-Pin Connector : The Centronics-standard plug and connector at 

the line printer. 


Table 5-2. Line Printer Pin Assignments 


50 -Pin 

50-Pin 

— CENTRONICS-Standard ~ 

iSBC 

Edge 

30-Pin 


Connector 

Connector 

Connector 

Signal 

24 

23 

1 

Character strobe to printer 

26 

25 

13 

SECT (Select) 

28 

27 

12 

Paper Out 

30 

29 

10 

ACKNOWLEDGE from printer 

34 

33 

9 

Data Bit 7 

36 

35 

8 

Data Bit 6 

38 

37 

7 

Data Bit 5 

40 

39 

6 

Data Bit 4 

42 

41 

5 

Data Bit 3 

44 

43 

4 

Data Bit 2 

46 

45 

3 

Data Bit 1 

48 

47 

2 

Data Bit 0 

NOTES : 




ISBC Connector: 

All odd pin numbers are grounded. 

Edge Connector: 

All even-numbered pins grounded. 

Centronics LP Connector: Pins 19-29 Protective grounds 



Pin 16 Logic Ground 



Pin 17 Chassis Ground 
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iSBC 95 7B PACKAGE 

You can use the parallel port for copying files to and from an Intellec 
Development System using an iSBC 957B hardware/ software package. This 
chapter describes changes to your Single Board Computer required to 
support the iSBC 957B package. Refer to the USER’S GUIDE FOR THE 
iSBC 957B iAPX 86, 88 INTERFACE AND EXECUTION PACKAGE for information 
about how to connect your system to a Development System. 


MODIFYING BOARDS 

This section describes how to modify your Single Board Computer, and the 
iSBC 208 Disk Controller Board. There is a section devoted to each of 
the following: 

• iSBC 208 Flexible Diskette Controller 

• iSBC 86/12A Single Board Computer 

• ISBC 86/14 Single Board Computer 

• iSBC 86/30 Single Board Computer 

In discussions of how to modify boards, the term "modify" means 
installing non-standard jumpers, and installing components on the board 
(such as the EPROMs that come as part of the iRMX 86 PC System). The 
discussions in this chapter assume: that you have a hardware reference 
manual for the board you are modifying, and that boards you modify have 
only the factory-installed jumpering in place. 

To modify a Single Board Computer to support the iRMX 86 PC Operating 
System, you must know: 

• Whether you are using the parallel port for a line printer or for 
an iSBC 95 7B package. 

• Whether your board has an iSBC 337 Multimodule Numeric Data 
Processor ( "NDP" ). 

• Whether you are using a RAM expansion module on your Single Board 
Computer. 

• Whether you are using serial bus priority resolution (the factory 
default in all cases) or parallel priority resolution. 

The instructions that follow note when a particular jumper or device is 
affected by these variables. 

Comments describing the effect of jumpers are very brief; more cofripleLs 
descriptions are in the appropriate hardware reference mamial. 
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MODIFYING THE ISBC 208 CONTROLLER 

Regardless which Single Board Computer you are using for your system, the 
iSBC 208 Disk Controller is jumpered the same way. The jumpers are shown 
in Table 5-3. 


Table 5-3. ISBC® 208 Jumpers 


Remove Jumper 

Add Jumper 

Function/Description 


E79-E84 

Interrupt level 5 

E45-E49 

E41-E45 

16-bit I/O address decoding. 

E77-E78 


Only if parallel bus priority resolution 
is used. (Factory sends board with this 
jumper removed, for serial bus priority 
resolution). 

NOTES : 

The iSBC 208 16-bit I/O base address is OOOOH (default). 

Hie controller comes from the factory supporting 8-inch flexible 
diskettes. The Operating System requires 8-lnch diskettes. 


The controller is documented in the iSBX 208 FLEXIBLE DISK DRIVE 
CONTROLLER HARDWARE REFERENCE MANUAL. 


5-6 










PREPARING YOUR HARDWARE 


MODIFYING THE ISBC 86/12A SINGLE BOARD COMPUTER 


The following tables list the modifications necessary to support the 
iRMX 86 PC Operating System with an iSBC 86/12A Microcomputer. 


Interrupt Level Jumpers 

Table 5-4 summarizes jumpers that establish interrupt levels. 

Table 5-4. Interrupt Jumpers for iSBC® 86/12A 


Add Jumper 

Function/Description 

E81-E1 

Interrupt Level 0, iSBC 337 

(1) 

E72-E89 

Level 1, Non-Maskable Interrupt 


E80-E84 

Level 1, Line Printer 


E79-E83 

Level 2, System Clock 

(2) 

E68-E76 

Level 5, iSBC 208 

(2) 

E75-E82 

Level 6, Terminal Driver (Read) 


E74-E90 

Level 7, Terminal Driver (Write) 



NOTES: 

(1) This jumper is for an iSBC 86/12A with PWA number of 
142977-XXX. If an older version of an iSBC 86/12A is used, 
refer to the iSBC 337 MULTIMODULE NUMERIC DATA PROCESSOR 
HARDWARE REFERENCE MANUAL. 

(2) Factory-installed jumpers. 


Additional Jiuapers 

Table 5-5 summarizes additional jumpering of the ISBC 86/12A. 


Table 5-5. Other iSBC® 86/12A Jumpers 


Remove Jumper 

Add Jumper 

Function/Description 

E125-E126 

E97-E98 

E151-E152 

E51-E52 

E127-E128 

E12-E21 

E97-E99 

E5-E6 

Clear To Send signal capability 
Set dual-port RAM address 
Only if iSBC 337 is not used 
Required by Monitor EPROMs 
Unpopulated memory or port time-out 
Only for parallel priority resolution 
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Parallel Port 

Table 5~6 summarizes jumper setting for the iSBC 8 6/ 12A Parallel Port, 
which can be used for either a line printer or an iSBC 957B package. 


Table 5-6. ISBC® 86/12A Parallel Port Jumpers 


ISBC 

957B 

Line Printer 

Remove 

Add 

Remove 

Add 

Jumper 

Jumper 

Jumper 

Jumper 

E13-E14 

E13-E27 

E13-E14 

E22-E32 

E19-E20 

E14-E30 

E32-E33 


E21-E25 

E18-E31 



E26-E2 7 

E20-E33 



E30-E31 

E25-E31 



E32-E33 





Switch Settings 

Table 5-7 Shows the settings for each position (segment) of Switch 1. 

Table 5-7. ISBC® 86/12A Switch 1 


Position 

Setting 

Position 

Setting 

1 

ON 

5 

OFF 

2 

(1) 

6 

OFF 

3 

OFF 

7 

ON 

4 

OFF 

8 

OFF 

NOTE: (1) 

Switch 2 must be OFF 

if you are using an iSBC 300 RAM 


Expansion Module, otherwise ON^ 
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Devices 


Table 5-8 describes the devices that must be installed on your 
iSBC 86/12A Board. 


Table 5-8. ISBC® 86/12A Devices 


Device 

Part Number 

So cket 

2732A EPROM 
2732A EPROM 
2132k EPROM 
2132k EPROM 

iSBC 902 Resistor packs 
7438 IC 

Status Adapter 

144447-001 

144448-001 

144449-001 

144450-001 

4500645-01 

100908-001 

1002129 

A28 

A29 

A46 

A47 

AlO, A12, A13 
All (1) 

All (2) 

NOTES: 

(1) If parallel port is used for line printer. 

(2) If parallel port is used for iSBC 957B package. 


The ISBC 86/12A is documented in the iSBC® 86/12A Single Board Computer 
Hardware Reference Manual (Order Number 9803074). 
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MODIFYING THE iSBC 86/14 SINGLE BOARD COMPUTER 

The following tables list modifications necessary to support the 
iRMX 86 PC Operating System with an iSBC 86/14 Single Board Computer, 


Jumpers 

Table 5-9 summarizes jumpers that establish interrupt level jimpers. 
Table 5-10 summarizes parallel port jumpers, and Table 5-11 shows all 
other jumpers that must be Installed on the iSBC 86/14 Board, 


Table 5-9, Interrupt Jumpers for iSBC® 86/14 


Remove Jumper 

Add Jumper 

Function/Description 

E144-E145 

E165-E166 
El 45-El 49 
E132-E164 
E147-E158 
E151-E152 
E153-E155 
E134-E154 

Interrupt Level 0, iSBC 337 
Level 1, Non-Maskable Interrupt 

Level 1, Line Printer 

Level 2, System Clock (1) 

Level 5, ISBC 208 (1) 

Level 6, Terminal Driver (Read) 

Level 7, Terminal Driver (Write) 

NOTE: (1) Factory-installed jumpers. 


Table 5-10, iSBC® 86/14 Parallel Port Jumpers 


If iSBC 957B 

is used 

If Line Printer is used 

Remove 

Add 

Remove 

Add 

Jumper 

Jumper 

Jumper 

Jumper 

E44-E53 

E44-E59 

E44-E53 

E60-E63 

E45-E54 

E45-E50 

E51-E60 


E46-E55 

E45-E54 



E48-E57 

E46-E51 



E50-E59 

E48-E53 



E51-E60 

E50-E52 



E52-E61 
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Table 5-11. Other iSBC® 86/14 Jumpers 


Remove Jumper 

Add Jumper 

Function/Description 


E76-E77 

Clear To Send signal capability. 

E219-E225 


Set dual-port RAM address 


E61-E62 

Only if iSBC 337 is not used. 

E26-E27 


Enable Non-Maskable Interrupt 

E33-E34 


Non-bus vector interrupt 


E36-E37 

Selects 5MHz clock (1) 


E124-E125 

Selects 2732-type EPROM 

El 11-El 12 

El 12-El 13 

2732 EPROM address range 


E119-E120 

If RAM Expansion Module is used 


E230-E231 

If RAM expansion module not used 


E232-E233 

Dual-port Ram Addressing 

E210-E211 


For parallel priority resolution 

NOTE: (1) 5 MHz required if 

ISBC 337 NDP is used. 


Devices 

Table 5-12 describes the devices that must be installed on your 
iSBC 86/14 Board. 


Table 5-12. iSBC® 86/14 On-Board Devices 


Device 

Part Number 

Socket 

2732A EPROM 
2732A EPROM 
1732k EPROM 
2732A EPR(M 
902 Resistor Packs 
7438 IC 

Status Adapter 

144447-001 

144448-001 

144449-001 

144450-001 

4500645-01 

100908-001 

1002129 

U57 

U58 

U39 

U40 

U18, U20, U21 

U19 If Line Printer used 

U19 If iSBC 957B used 


The iSBC 86/14 Single Board Computer is documented in the iSBC® 86/14 AND 
iSBC® 86/30 SINGLE BOARD COMPUTER HARDWARE REFERENCE MANUAL. 
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MODIFYING THE iSBC 86/30 SINGLE BOARD COMPUTER 

The following tables list modifications necessary to support the 
iRMX 86 PC Operating System with an iSBC 86/30 Single Board Computer. 


Jumpers 

Table 5-13 summarizes jumpers that establish interrupt level jumpers, 
Table 5-14 summarizes parallel port jumpers, and Table 5-15 summarizes 
all other jumpers that must be installed on your iSBC 86/30 Board. 


Table 5-13. Interrupt Jumpers for ISBC® 86/30 


Remove Jumper 

Add Jumper 

Function/Description 

E144-E145 

E165-E166 
E145-E149 
E132-E164 
E147-E158 
E151-E152 
El 53-El 55 
E134-E154 

Interrupt Level 0, ISBC 337 
Level 1, Non-Maskable Interrupt 

Level 1, Line Printer 

Level 2, System Clock (1) 

Level 5, iSBC 208 (1) 

Level 6, Terminal Driver (Read) 

Level 7, Terminal Driver (Write) 

NOTE: (1) Factory-installed jumpers. 


Table 5-14. iSBC® 86/30 Parallel Port Jumpers 


If iSBC 957B 

is used 

If Line Printer is used 

Remove 

Add 

Remove 

Add 

Jumper 

Jumper 

Jumper 

Jumper 

E44-E53 

E44-E59 

E44-E53 

E60-E63 

E45-E54 

E45-E50 

E51-E60 


E46-E55 

E45-E54 



E48-E57 

E46-E51 



E50-E59 

E48-E53 



E51-E60 

E50-E52 



E52-E61 


i 
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Table 5-15. Other iSBC® 86/30 Jumpers 


Remove Jtimper 

Add Jumper 

Function/Description 


E76-E77 

Clear To Send signal capability. 

E219-E225 


Set dual-port RAM address 


E61-E62 

Only if iSBC 337 is not used. 

E26-E27 


Enable Non-Maskable Interrupt 

E33-E34 


Non-bus vector interrupt 


E36-E37 

Selects 5MHz clock (1) 


E124-E125 

Selects 2732-type EPROM 

E111-E112 

E112-E113 

2732 EPROM address range 


E119-E120 

If RAM Expansion Module is used 


E232-E233 

If RAM expansion module not used 

E210-E211 


For parallel priority resolution 

NOTE: (1) 5 MHz required if 

ISBC 337 NDP is used. 


Devices 

Table 5-16 describes the devices that must be installed. 


Table 5-16. iSBC® 86/30 On-Board Devices 


Device 

Part Number 

Socket 

2732A EPROM 
2732A EPROM 
2732A EPROM 
2732A EPROM 
902 Resistor Packs 
7438 IC 
Status Adapter 

144447-001 

144448-001 

144449-001 

144450-001 

4500645-01 

100908-001 

1002129 

U57 

U58 

U39 

U40 

U18, U20, U21 

U19 If Line Printer used 

U19 If iSBC 957B used 


The ISBC 86/30 Single Board Computer is documented in the iSBC® 86/14 AND 
iSBC® 86/30 SINGLE BOARD COMPUTER HARDWARE REFERENCE MANUAL. 
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CONVENIENCE CHARTS 

The next four pages are printed for your convenience in working with the 
the boards that you must modify. You are invited to remove these pages 
and use them as work guides. There is one page each for the following 
boards: : 

• iSBC 86/12A Single Board Computer 

• iSBC 86/14 Single Board Computer 

• iSBC 86/30 Single Board Computer 

• iSBC 208 Flexible Disk Controller 

The iSBC 208 page also includes the Centronics-to-parallel port 
information, in case you must connect a line printer to one of the 
computers. 
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Table 5-17. iSBC® 86/12A Jumpers (Condensed) 


Remove 

Add 

Function/ 

Jumper 

Jumper 

Description 


E81-E1 

Interrupt Level 0, iSBC 337 (1) 


E72-E89 

Level 1, Non-Maskable Interrupt 


E80-E84 

Level 1, Line Printer 


E79-E83 

Level 2, System Clock (factory-installed jumper) 


E68-E76 

Level 5, ISBC 208 (factory-installed jumper) 


E75-E82 

Level 6, Terminal Driver (Read) 


E74-E90 

Level 7, Terminal Driver (Write) 


E51-E52 

Clear-To-Send signal capability. 

E125-E126 

E127-E128 

Set dual-port RAM address 

E97-E98 

E97-E99 

Required for Monitor in EPROMs 


E12-E21 

Only if iSBC 337 is not used. 


E5-E6 

Unpopulated memory or port time-out 

E151-E152 


Only for parallel priority resolution 

E13-E14 

E13-E27 

If parallel port is used for 957B 

E19-E20 

E14-E30 


E21-E25 

E18-E31 


E26-E27 

E20-E33 


E30-E31 

E25-E31 


E32-E33 



El 3-El 4 

E22-E32 

If parallel port is used for line printer 

E32-E33 



(1) Applies only to iSBC 86/12A with PWA of 142977-XXX 


Table 5-18. ISBC® 86/12A Devices (Condensed) 


Device 

Part Number 

Socket 

273 2A EPROM 
2732A EPROM 
2732A EPROM 
2732A EPROM 
902 Resistor Packs 
7438 IC 
Status Adapter 

144447-001 

144448-001 

144449-001 

144450-001 

4500645-001 

100908 

1002129 

A28 

A29 

A46 

A47 

AlO, A12, A13 

All Parallel port used for line printer 
All Parallel port used for iSBC 957B 


Table 5-19. iSBC® 86/12A Switch 1 (Condensed) 
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Table 5-20. iSBC® 86/14 Jumpers (Condensed) 


Remove 

Jumper 


Add 

Jumper 

Function/ 

Description 

E165-E166 

Interrupt Level 0, iSBC 337 

E145-E149 

Level 1, Non-Maskable Interrupt 

E132-E164 

Level 1, Line Printer 

E147-E158 

Level 2, System Clock (factory-installed jumper) 

E151-E152 

Level 5, iSBC 208 (factory-installed jumper) 

E153-E155 

Level 6, Terminal Driver (Read) 

E134-E154 

Level 7, Terminal Driver (Write) 

E76-E77 

Clear-To-Send signal capability 
Set dual-port RAM address 
Enable Non-Maskable Interrupt 
Non-bus vector Interrupt 

E61-E62 

If iSBC 337 is not used* 

E36-E37 

Selects 5MHz clock (required if ISBC 337 is used) 

E124-E125 

Selects 2732-type EPROM 

E112-E113 

EPROM address range 

Only for parallel priority resolution 

E119-E120 

86/14 with ISBC 300A RAM expansion module 

E232-E233 


E230-E231 

86/14 without RAM expansion module 

E232-E233 


E44-E59 

E45-E50 

E45-E54 

E46-E51 

E48-E53 

E50-E52 

If parallel port is used for 957B 

E60-E63 

If parallel port is used for line printer 


E144-E145 


E219-E225 

E26-E27 

E33-E34 


El 11-El 12 
E210-E211 




E44-E53 

E45-E54 

E46-E55 

E48-E57 

E50-E59 

E51-E60 

E52~E61 


E44-E53 

E51-E60 


Table 5-21. ISBC® 86/14 Devices (Condensed) 


Device 

Part Number 

Socket 

2732A EPROM 
2732A EPROM 
273 2A EPROM 
2732A EPROM 
902 Resistor Packs 
7438 IC 

Status Adapter 

144447-001 

144448-001 

144449-001 

144450-001 

4500645-01 

100908-001 

1002129 

U57 

U58 

U39 

U40 

U18, U20, U21 

U19 If parallel port used for Line Printer 
U19 If parallel port used for iSBC 957B 
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Table 5-22, ISBC® 86/30 Jumpers (Condensed) 


Remove 

Add 

Function/ 

Jumper 

Jumper 

Description 


E165-E166 

Interrupt Level 0, iSBC 337 

E144-E145 

E145-E149 

Level 1, Non-Maskable Interrupt 


E132-E164 

Level 1, Line Printer 


El 47 -El 5 8 

Level 2, System Clock (factory-installed jumper) 


E151-E152 

Level 5, iSBC 208 (factory-installed jumper) 


E153-E155 

Level 6, Terminal Driver (Read) 


E134-E154 

Level 7, Terminal Driver (Write) 


E76-E77 

Clear-To-Send signal capability 

E219-E225 


Set dual-port RAM address 

E26-E27 


Enable Non-Maskable Interrupt 

E33-E34 


Non-bus vector interrupt 


E61-E62 

If iSBC 337 is not used. 


E36-E37 

Selects 5MHz clock (required with iSBC 337) 


E124-E125 

Selects 2732-type EPROM 

E111~E112 

El 12-El 13 

EPROM address range 

E210-E211 


Only for parallel priority resolution 


E119-E120 

86/30 with iSBC 304 RAM expansion module 


E232-E233 

86/30 without RAM expansion module 

E44-E53 

E44-E1)9 

If parallel port is used for 957B 

E45-E54 

E45-E50 


E46-E55 

E45-E54 


E48-E57 

E46-E51 


E50-E59 

E48-E53 


E51-E60 

E50-E52 


E52-E61 



E44-E53 

E60-E63 

If parallel port is used for line printer 

E51-E60 




Table 5-23. iSBC® 86/30 Devices (Condensed) 


Device 

Part Number 

Socket 

273 2A EPROM 
2732A EPROM 
273 2A EPROM 
2732A EPROM 
902 Resistor Packs 
7438 IC 

Status Adapter 

144447-001 

144448-001 

144449-001 

144450-001 

4500645-01 

100908-001 

1002129 

U57 

U58 

U39 

U40 

U18, U20, U21 

U19 If parallel port used for Line Printer 
U19 If parallel port used for iSBC 957B 
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Table 5”24. iSBC® 208 Jumpers (Condensed) 


Remove Jumper 

Add Jumper 

Function/Description 


E79-E84 

Interrupt level 5 

E45-E49 

E41-E45 

16-bit I/O address decoding. 

E77-E78 


Only if parallel bus priority resolution 
is used. (Factory sends board with this 
jumper removed, for serial bus priority 
resolution). 


iINE PRINTER SIGNALS 


Table 5-25. Line Printer Pin Assignments (Condensed) 


50 -Pin 

50-Pin 

— CENTRONICS-Standard — 

iSBC 

Edge 

30-Pin 


Connector 

Connector 

Connector 

Signal 

24 

23 

1 

Character strobe to printer 

26 

25 

13 

SLCT (Select) 

28 

27 

12 

Paper Out 

30 

29 

10 

ACKNOWLEDGE from printer 

34 

33 

9 

Data Bit 7 

36 

35 

8 

Data Bit 6 

38 

37 

7 

Data Bit 5 

40 

39 

6 

Data Bit 4 

42 

41 

5 

Data Bit 3 

44 

43 

4 

Data Bit 2 

46 

45 

3 

Data Bit 1 

48 

47 

2 

Data Bit 0 

GROUNDS 




iSBC Connector: All odd pin numbers are grounded. 

Edge Connector: All even-numbered pins grounded. 

Centronics LP Connector: Pins 

19-29 Protective grounds 



Pin 

16 Logic Ground 



Pin 

17 Chassis Ground 
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CHAPTER 6. DOCUMENTATION 


This chapter lists and briefly describes documentation that applies to 
the iRMX 86 PC Operating System. We have included descriptions of 
iRMX 86 software manuals, as well as manuals describing hardware that can 
be used with the iRMX 86 PC product. 


THIS MANUAL 

The GETTING STARTED WITH THE iRMX 86 SYSTEM is designed to be a 
self-contained sunimary of the information you need to use the iRMX 86 PC 
Operating System. Much of the information in this manual is repeated in 
other manuals described here. 


iRMX 86 MANUALS 


These are the manuals that document the IRMX 86 Operating System. 

• INTRODUCTION TO THE IRMX ^86 OPERATING SYSTEM (Order Number: 
9803124) 

This manual is designed to introduce engineers and managers to 
the IRMX 86 Operating System. It describes how the iRMX 86 
Operating System can help you develop your application system in 
less time and at less expense. 


• iRMX 86 NUCLEUS REFERENCE MANUAL (Order Number: 9803122) 

This manual documents the Nucleus, the central portion of the 
iRMX 86 Operating System required by all application systems. It 
provides overview information, discusses the functions of the 
Nucleus in detail, and contains detailed descriptions of the 
system calls available to application programmers. 


• IRMX 86 BASIC I/O SYSTEM REFERENCE MANUAL (Order Number: 9803123) 

This manual describes the Basic I/O System, a layer of the iRMX 
86 Operating System that provides flexible I/O features that are 
useful in a broad range of applications. It contains some 
introductory and overview material as well as detailed 
descriptions of the system calls available to application 
programmers. 
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• iRMX 86 EXTENDED I/O SYSTEM REFERENCE MANUAL (Order Number: 
143308) 

This manual describes the Extended I/O System, a layer of the 
iRMX 86 Operating System that provides easy-to-use, 
more-automatic I/O features. It contains some introductory and 
overview material as well as detailed descriptions of the system 
calls available to application programmers. 


• iRMX 86 LOADER REFERENCE MANUAL (Order Number: 143318) 

This manual describes the two loaders available with the iRMX 86 
Operating System: the Bootstrap Loader and the Application 
Loader. It contains some introductory and overview material as 
well as detailed descriptions of the system calls available with 
the Application Loader. 


• iRMX 86 HUMAN INTERFACE REFERENCE MANUAL (Order Number: 9803202) 

This manual documents the Human Interface, the layer of the IRMX 
86 Operating System that provides an interactive interface 
between the user and the application system. It provides 
introductory and overview information, describes the commands 
available with the Human Interface (the same commands described 
in Chapter 3 of the manual you are reading) , discusses the 
process of creating your own commands, and describes Human 
Interface system calls. 


# iRMX 86 DISK VERIFICATION UTILITY REFERENCE MANUAL (Order Number: 
144133) 

This manual documents the Disk Verification Utility. The 
DISKVERIFY command (see Chapter 3 of the manual you are reading) 
Invokes this utility. The DISK VERIFICATION UTILITY REFERENCE 
MANUAL provides more in-depth information, including detailed 
descriptions of the structure of IRMX 86 files. 


• iRMX 86 SYSTEM PROGRAMMER'S REFERENCE MANUAL (Order Number: 
142721) 

This manual documents advanced features of the iRMX 86 Operating 
System normally used by system programmers. The manual includes 
discussions of regions, attaching 1/0 devices, and creating user 
objects* It contains detailed descriptions of those system calls 
normally reserved for system programmers. 
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iRMX 86 PROGRAMMING TECHNIQUES MANUAL (Order Number: 142982) 

This manual provides a number of programming techniques that can 
reduce the amount of time you spend designing and implementing 
your iRMX 86~based application system. It includes discussions 
on PL/M-86 size controls. Interface procedures, INCLUDE files, 
timer routines, assembly language programming, job communication, 
configuration, deadlock, terminal I/O, and stack sizes. 


GUIDE TO WRITING DEVICE DRIVERS FOR THE iRMX 86 AND iRMX 88 I/O 
SYSTEMS (Order Number: 142926) 

For the programmer who is using the configurable iRMX 86 
Operating System, this manual shows how to Incorporate a custom 
driver into the system. This applies to devices for which the 
iRMX 86 Operating System does not already supply device drivers. 


iRMX 86 CONFIGURATION GUIDE (Order Number: 9803126) 

Again, for the programmer who is using the configurable iRMX 86 
Operating System, this manual describes how to define the 
characteristics of iRMX 86 layers that are appropriate a 
particular application. 


iRMX 86 INSTALLATION GUIDE (Order Number: 9803125) 

This manual contains hardware Information for the configurable 
IRMX 86 Operating System (equivalent to the hardware information 
in this manual) and a description of the iRMX 86 Patching Utility. 



DOCUMENTATION 


LANGUAGE TRANSLATORS AND UTILITIES MANUALS 


The following manuals document the language products that can be used 
with your iRi^fX 86 PC Operating System. 

• EDIT REFERENCE MANUAL (Order Number: 143587) 

This manual documents EDIT, an iRMX 86-based text editor. It 
contains introductory and tutorial material as well as detailed 
descriptions of all EDIT commands. 


• GUIDE TO USING iRMX 86 LANGUAGES (Order Number: 143907) 

This manual provides an overview of the language products that 
run in an iRMX 86 environment. It shows how to invoke the 
products from the Human Interface and lists the invocation 
controls for each product. It then refers you to other language 
and utilities manuals for detailed information about the 
products. You should read this manual before you read the other 
language and utilities manuals, because this manual provides 
information that you need to run the language products in an iRMX 
86 environment. It also identifies portions of the other manuals 
that do not apply to the iRMX 86 versions of the language 
products. 


• 8086/8087/8088 MACRO ASSEMBLY LANGUAGE REFERENCE MANUAL FOR 

8086-BASED DEVELOPMENT SYSTEMS (Order Number: 121627) 

This manual documents the 8086/8087/8088 macro assembly language, 
ASM86. It describes the assembly language instructions and the 
macro processing language. 


• 8086/8087/8088 MACRO ASSEMBLER OPERATING INSTRUCTIONS FOR 

8086-BASED DEVELOPMENT SYSTEMS (Order Number 121628) 

This manual describes how to invoke the assembler, and how to 
link assembly language programs with PL/M-86 programs. 


• PL/M-86 USER'S GUIDE FOR 8086-BASED DEVELOPMENT SYSTEMS (Order 

Number: 121636) 

This manual describes the PL/M-86 language and use of the PL/M-86 
compiler. It describes language statements, discusses compiler 
invocation, and documents each compiler control. 
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• lAPX 86,88 FAMILY UTILITIES USER’S GUIDE FOR 8086-BASED 

DEVELOPMENT SYSTEMS (Order Number: 121616) 

This manual contains descriptions of the program development 

utilities: 

• LINK86, which links 8086 object modules together and resolves 
global references between modules 

• LOC86, which changes 8086 relocatable object modules into 
absolute modules 

• LIB86, a utility that creates and maintains object libraries 

• OH86, which converts 8086 absolute object modules to 
hexadecimal format 


• Pascal-86 USER’S GUIDE (Order Number: 121539) 

This manual describes the Pascal language and the use of the 
Pascal-86 compiler. It provides complete descriptions of all 
Pascal language statements, discusses compiler invocation, and 
documents each of the compiler controls. The Pascal-86 compiler 
is a strict implementation of the proposed ISO standard that also 
provides extensions of the language oriented toward 
microcomputers. 


• FORTRAN-86 USER’S GUIDE (Order Number: 121570) 

This manual describes the FORTRAN language and the use of the 
FORTRAN-86 compiler. It provides complete descriptions of all 
FORTRAN language statements, discusses compiler invocation, and 
documents each of the compiler controls. This FORTRAN-86 
compiler produces code that is compatible with existing 
FORTRAN-86 code and includes many new features of the FORTRAN-77 
standard. 


• RUN-TIME SUPPORT MANUAL FOR iAPX 86, 88 APPLICATIONS (Order 
Number: 121776) 

This manual describes the run-time aids that Intel offers for the 
iAPX 86, 88 family of processors. This is the basic reference 
manual for the Universal Development Interface used with Intel 
Operating Systems. 
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• USER'S GUIDE FOR THE iSBC 957B iAPX 86, 88 INTERFACE AMD 
EXECUTION PACKAGE (Order Number 143979) 

This manual provides general information, interfaelng 
instructions, and programming information for the iSBC 95 7B 
loader and monitor* It provides detailed descriptions of the 
loader and monitor commands and describes how to connect an Intel 
development system to an iAPX 86--based boards* It also contains 
configuration information, which may be of little Importance to 
you since the monitor is already configured and available in PROM 
as part of the iRMX 86 PC package* 


HARDWARE MANUALS 

These manuals document hardware that you can use with your iRMX 86 PC 
Operating System. 


COMPUTERS 

The computers that you can use for your iR^lX 86 PC Operating System are 
described in these two manuals. 

• iSBC 86/12A SINGLE BOARD COMPUTER HARWARE REFERENCE MANUAL 
(Order Number: 9803074) and 

• ISBC 86/14 and iSBC 86/30 SINGLE BOARD COMPUTER HARDWATE 
REFERENCE MANUAL (Order Number: 144044) 

These two manuals describe, for each computer, principles of 
operation, programming considerations, and how to incorporate 
iSBC Multimodule units (like on-board RAM and and the 8087 
Numeric Processor Extenmsion). 


DISK CONTROLLER 

# iSBX 208 FLEXIBLE DISK CONTROLLER HARDWARE REFERENCE MANUAL 
(Order Number: 143078) 

The manual describes specifications, jumper configurations, 
programming considerations, and principles of operation of the 
iSBX 208 Flexible Disk Controller board. 
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MEMORY BOARDS 

• iSBC 016A/032A/064A/028A/056A RAM MEMORY BOARD HARDWARE REFERENCE 
MANUAL (Order Number: 143572) 

This manual describes specifications, jumper configurations, 
programming considerations, and principles of operation of 
iSBC 056A RAM memory boards. 


CHASSIS /POWER SUPPLY 

• iSBC 680/681 MULTI STORE USER SYSTEM PACKAGE HARDWARE REFERENCE 
MANUAL (Order Number: 162432) 

This manual provides information about the iSBC 680-serles 
module, which is a chassis containing a power supply and Multibus 
card cage in which you can install your Intel iSBC boards. 


You can order any manual described in this chapter from: 

Literature Department 
Intel Corporation 
3065 Bowers Avenue 
Santa Clara, CA 95051 
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APPENDIX A. iRMX~ 86 EXCEPTION CODES 


This appendix contains the exception codes that are generated by the 
iRMX 86 Operating System. Exception codes are any condition codes other 
than E$OK, the normal code. Exception codes are classed as either 
"Environmental Conditions" or "Programmer Errors”, although the latter 
includes certain hardware errors. 

The values of these exception codes fall into ranges based on the layer 
which first detects the condition. Table A-1 lists the layers and their 
respective ranges, with numeric values expressed in hexadecimal notation. 


Table A-1. Exception Code Ranges 


Layer 

Environmental 

Programming 

Nucleus 

0 to IFH 

8000 to 801FH 

Basic I/O System 

20 to 3FH 

8020 to 803FH 

Extended I/O System 

40 to 5FH 

8040 to 805FH 

Application Loader 

60 to 7FH 

8060 to 807FH 

Human Interface 

80 to AFH 

8080 to 80AFH 

Universal Development 

CO to DFH 

80C0 to 80DFH 

Interface 



Reserved 

130 to 14FH 

8130 to 814FH 
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Table A-"2 below shows the value of each code, the associated mneinotiic, 
and a descriptive itieanlng. In addition, the table shows the the layer (s) 
of the system that could generate the code. In case you wish to refer the 
the appropriate manual. Since certain system calls in the IRMX 86 
Operating System are considered to be System Programmer calls and are 
documented in the IRMX 86 System Programmer Reference Manual, this manual 
is also mentioned. 


Table A-2. IRMX^ 86 Condition Codes 


Hex. 

Value 

Mnemonic 

Manual s 
N B E L H 

Meaning 

OH 

E$OK 

it :k ^ :k 

No exceptional conditions (normal) 


Environmental Conditions 


IH 

E$TIME 

* * * * 

A time limit (possibly a limit of 
zero time) expired without a task's 
request being satisfied. 

2H 

3H 

E$MEM 

1 

E$BUSY 

it ic ic it ic 

S 

Insufficient available memory to 
satisfy a task's request. 

Another task currently has access to 
data protected by a region. 

4H 

E$LIMIT 

it it it it it 

A task attempted an operation which, 
if it had been successful, would have 
violated a Nucleus-enforced limit. 

5H 

E$CONTEXT 

it it it it it 

A system call was issued out of 
proper context. 

6H 

E$EXIST 

it it it it it 

A token parameter has a value which 
is not the token of an existing 
object. 


N Nucleus Reference Manual L Loader Reference Manual 

B Basic I/O System Ref Manual H Human Interface Reference Manual 

E Extended I/O Sys Ref Manual S System Programmer's Ref Manual 
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Table A-2. iRMX™ 86 Condition Codes (continued) 


Hex. 

Value 

Mnemonic 

Manuals 
N B E L H 

Meaning 

Environmental Conditions (continued) 

7H 

E$STATE 

* 

A task attempted an operation which 
would have caused an impossible 
transition of a task’s state. 

8H 

E$NOT$CON- 

FIGURED 

"k ic ic -k 

This system call is not part of the 
present configuration. 

9H 

E$INTER- 

RUPT$SAT- 

URATION 

k 

An interrupt task has accummulated the 
maximum allowable amount of 
SIGNAL$INTERRUPT requests. 

OAH 

E$INTER- 

RUPT$- 

OVERFLOW 

k 

An interrupt task has accummulated 
more than the maximum allowable amount 
of SIGNAL$INTERRUPT requests. 

20H 

E$FEXIST 

k k 

File already exists. 

21H 

E$FNEXIST 

k k k k 

File does not exist. 

22H 

E$DEVFD 

k k k 

Device and file driver are 
incompatible. 

23H 

E$SUPPORT 

k k k k 

Combination of parameters not 
supported. 

24H 

E$EMPTY$- 

ENTRY 

k k 

The specified slot in a directory 
file is empty. 

25H 

E$DIR$END 

k k 

\ 

The specified slot is beyond the end 
of a directory file. 

26H 

E$FACCESS 

k k k k 

File access not granted. 

27H 

E$FTYPE 

k k k 

Incompatible file type. 

28H 

E$SHARE 

k k k k 

Improper file sharing requested. 

29H 

E$ SPACE 

k k 

No space left. 

N Nucleus Reference Manual 

B Basic I/O System Ref Manual 

E Extended I/O Sys Ref Manual 

L Loader Reference Manual 

H Human Interface Reference Manual 

S System Progranmier ’s Ref Manual 
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Table A-2. iRMX™ 86 Condition Codes (continued) 


Hex. 

Value 

— 

Mnemonic 

Manuals 
N B E L H 

Meaning 


Environmental Conditions (continued) 

2AH 

E$IDDR 

* * 

Invalid device driver request. 

2BH 

E$IO 


An I/O error occured. 

2CH 

E$FLUSHING 

* * * 

Connection specified in call was 
deleted before the operation was 
completed. 

2DH 

E$ILLVOL 

s * 

Invalid ly named volume. 

2EH 

E$DEV$0 FE- 
LINE 

* 

The device being accessed if now 
offline. 

40H 

E$PREFIX$- 

SYNTAX 

* ^ 

The specified path starts with a colon 
(:) but does not contain a second, 
matching colon. 

41H 

E$CANNOT$- 

CLOSE 

* 

The Extended I/O System was not able 
to transfer remaining data in buffers 
to output device. 

42H 

E$IOMEM 

* * 

The Basic I/O System has insufficient 
memory to process a request. 

44H 

E$MEDIA 

* * 

The device containing a specified 
file is not online. 

45H 

E$LOG$NAME- 

NEXIST 

* * 

The Extended I/O System was unable 
to find a specified logical name in 
the object directories that it checks. 

6 OH 

E$ABS$ADD- 

RESS 

* 

An absolute object program was loaded 
into system protected memory area. 

61H 

E$BAD$GROUP 

* 

Illegal group component in the a 
group definition record. 

62H 

E$BAD$- 

HEADER 

I 

1 

* * 

Illegal header record in the object 
file. 

N Nucleus Reference Manual 

L Loader Reference Manual 

B Basic I/O System Ref Manual 

H Human Interface Reference Manual 

E Extended I/O Sys Ref Manual 

S System Programmer's Ref Manual 
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Table A-2. iRMX"* 86 Condition Codes (continued) 


Hex. 

Value 

Mnemonic 

Manuals 
N B E L H 

Meaning 

Environmental Condi t ions ( continued ) 

63H 

E$BAD$SEG- 

MENT 

•k k 

Illegal segment definition record. 

64H 

E$CHECKSUM 

k k 

A checksum error occurred while 
reading an object record. 

65H 

E$EOF 

k k 

Unexpected end of file encountered 
while reading object records. 

66H 

E$FIXUP 

k k 

Illegal fixup record in the object 
file. 

67H 

E$NO$LOADER 

$MEM 

k k 

Insufficient memory to satisfy 
loader dynamic memory requirements. 

68H 

E$NO$MEM 

k k 

Insufficient memory to create PIC/LTL 
segments. 

69H 

E$REC$FMT 

k k 

Illegal record format encountered. 

6AH 

E$REC$- 

LENGTH 

k k 

Record length of an object record 
exceeds configured loader-buffer size. 

6BH 

E$REC$TYPE 

k k 

Illegal record type encountered in 
the object file. 

6CH 

E$NO$START 

k k 

Start address not found. 

6DH 

E$JOB$SIZE 

k k 

Maximum job-size specified is less 
than the memory requirement specified 
in the object file. 

6EH 

E$OVLY 

k 

Overlay name does not match with any 
of the overlay module names. 

6FH 

E$LOADER 
$ SUPPORT 

k k 

The object file being loaded requires 
features not supported by the 
configured loader. 


N Nucleus Reference Manual L Loader Reference Manual 

B Basic I/O System Ref Manual H Human Interface Reference Manual 

E Extended I/O Sys Ref Manual S System Programmer’s Ref Manual 
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Table A“2. iRMX” 86 Condition Codes (continued) 


Hex. 

Value 

Mnemonic 

Manuals 
N B E L H 

Meaning 



Environmental Conditions (continued) 


8 OH 

E$LITERAL 

* 

The parse buffer contains a literal 
with no closing quote. 

81H 

E$STRING$- 

BUFFER 


The string to be returned as the 
parameter name exceeds the size of 
the buffer the user provided in the 
cal 1 . 

82H 

E$SEPARA- 

TOR 


The parse buffer contains a command 
separator. 

83 

E$CONTINUED 

ie 

The parse buffer contains a 
continuation character. 

85H 

E$LIST 

* 

The last value of the value list is 
missing. 

87H 

E$PREPOSI- 

TION 


The same preposition as on the the 
command line was indicated, but can 
not be used. 

89H 

E$CONTROL$C 

* 

The user typed CONTROL-C while the 
command was being loaded. 

8BH 

E$EXTRA$SO 

* 

There were no more input pathnames 
although the output pathname list was 
not empty. 

Programmer Errors 

8000H 

E$ZERO$- 

DIVIDE 

* 

A task attempted to divide by zero. 

8001H 

E$OVER-FLOW 

* 

An overflow interrupt occurred. 

8002H 

. 

E$TYPE 

***** 

A token parameter referred to an 
existing object that is,, not of the 
required type. 


N Nucleus Reference Manual L Loader Reference Manual 

B Basic I/O System Ref Manual H Human Interface Reference Manual 

E Extended 1/ 0 Sys Ref Manual S System Programmer's Ref Manual 
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Table A-2. iRMX” 86 Condition Codes (continued) 


Hex. 

Mnemonic 

Manuals 

Meaning 

Value 


N B E L H 


Programmer Errors (continued) 

800 3H 

E$B0UNDS 

* 

A task attempted to access beyond the 




end of a segment. 

8004H 

E$PARAM 

***** 

A parameter which is neither a token 




nor an offset has an invalid value. 

8006H 

E$ARRAY$- 

* * 

Array overflow detected by hardware 


BOUNDS 

* 

or language processor. 

8007H 

E$NDP$- 

* 

8087 (Numeric Data Processor) error. 


ERROR 



8020H 

E$IFDR 

* * 

Invalid file driver request. 

8021H 

E$N0USER 

* * * 

No default user. 

8022H 

E$NO$PREFIX 

* * * 

No default prefix. 

8040H 

E$N0T$- 

* * 

Specified object is not a device 


PREFIX 


connection or file connection. 

8041H 

E$N0T$- 

* 

A token parameter referred to an 


DEVICE 


existing object that is not, but 




should be, a device connection. 

8042H 

E$N0T$C0N- 

* 

A token parameter referred to an 


NECTION 


existing object that is not, but 




should be, a file connection. 

8060H 

E$JOB$PARAM 

* * 

The maximum job-size specified is 




less than the minimum job-size. 

8080H 

E$PARSE$- 

* 

There is an error in the interal 


TABLES 


parse tables. 

8083H 

E$DEFAULT$SO 

* 

The default output name STRING is 




invalid. 

8084H 

E$STRING 

* 

The pathname to be returned exceeds 




255 characters in length. 

N Nucleus Reference Manual 

L Loader Reference Manual 

B Basic I/O System Ref Manual 

H Human Interface Reference Manual 

E Extended I/O Sys 

Ref Manual 

S System Programmer ’s Ref Manual 










APPENDIX B. iRMX~ 86 SYSTEM CALLS 


This chapter describes the system calls that the iRMX 86 Operating System 
recognizes* If you wish to use any of these calls with the iRMX 86 PC 
System, you must to obtain the manual that describes the system call 
(manuals are listed in Chapter 6) and you must link your programs to the 
appropriate library on the Library Diskette supplied with the iRMX 86 PC 
System. This Appendix lists the iRMX 86 System calls and briefly 
describes each call. The first section describes each layer of the 
Operating System. 


LAYERS OF THE iRMX 86 SYSTEM 


The Configurable IRMX 86 Operating System consists of a number of 
layers. The Operating System can be configured to include or exclude 
certain layers (the Nucleus is always Included) and to include or exclude 
optional features. (The configuration process has already been 
accomplished for users of the iRMX 86 PC Operating System.) 

The layers of the iRMX 86 Operating System are: 


Nucleus The Nucleus is the core of the iRMX 86 Operating System 

and is required by every application system. It 
provides facilities that perform processor management 
and scheduling, interrupt management, memory management, 
object control, and error management. Refer to the 
iRMX 86 NUCLEUS REFERENCE MANUAL and the iRMX 86 SYSTEM 
PROGRAMMER’S REFERENCE MANUAL for detailed information 
about the Nucleus. 


Basic I/O The Basic I/O System provides an extensive 
System facility for device-independent I/O. It supplies all 

file drivers and a number of device drivers. It 
implements an asynchronous interface to I/O operations, 
allowing tasks explicitly to overlap I/O functions with 
other operations. Refer to the iRMX 86 BASIC I/O SYSTEM 
REFERENCE MANUAL and the iRMX 86 SYSTEM PROGRAMMER’S 
REFERENCE MANUAL for more information. 


Extended I/O The Extended I/O System provides a higher-level 
System interface to files than the Basic I/O System provides. 

The Extended I/O System provides a simple, synchronous 
interface to I/O operations, one which automatically 
performs read-ahead and write-behind buffering. This 
synchronous Interface also allows tasks to use logical 
names to refer to files. All of the UDI File Management 
system calls (see Chapter 4 of this manual) are 
accomplished by the Extended I/O System. 
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Application 

Loader 


Bootstrap 

Loader 


Human 

Interface 


Refer to the iRMX 86 EXTENDED I/O SYSTEM REFERENCE 
MANUAL and the iRMX 86 SYSTEM PROGRAMMER’S REFERENCE 
MANUAL for more information. 

The Application Loader provides a simple 
mechanism for loading application code and data files 
from I/O devices into system memory. It can load 
absolute code into fixed locations, relocatable code 
into dynamically-allocated memory locations, and it can 
load files containing overlays. 

The Bootstrap Loader provides a means of loading 
the Operating System into system memory from an I/O 
device. It can also load a file you specified at the 
terminal. The Bootstrap Loader is in the EPROMs 
supplied with your iRMX 86 PC System. 

The Human Interface is the uppermost layer of the 
iRMX 86 Operating System. It is an interactive 
Interface between you and the application system. Using 
the Human Interface, you can invoke a program from the 
terminal by specifying the name of the file that 
contains the program. A set of programs, the Human 
Interface Commands , are supplied with the Operating 
System. These are the commands documented in Chapter 3 
of this manual. 

The Human Interface also provides a number of system 
calls that the application program can invoke to access 
Human Interface services* Refer to the iRMX 86 HUMAN 
INTERFACE REFERENCE MANUAL for more information. 
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NUCLEUS SYSTEM CALLS 
The Nucleus system calls 
ACCEPT$CONTROL 

CATALOG$OBJECT 

CREATE$JOB 

CREATE$MAILBOX 
CREATE$ SEGMENT 
CREATE$ SEMAPHORE 
CREATE$TASK 
DELETE$JOB 

DELETE$MAILBOX 
DELETE$ SEGMENT 

DELETE$SEMAPHORE 

DELETE$TASK 

DISABLE 

ENABLE 

EXIT$INTERRUPT 

GET$LEVEL 

GET$POOL$ATTRIBUTES 


are listed here. 

Gains control of a region only if the region is 
immediately available. 

Enters a name and token for an object into the 
object directory of a job. 

Creates an environment for a number of tasks and 
other objects, as well as creating an initial 
task and its stack. 

Creates a mailbox with queues for waiting tasks 
and objects with FIFO or PRIORITY dicipline. 

Dynamically allocates a specified number of 
16 -byte paragraphs. 

Creates a semaphore for synchronizing access to 
resources. 

Creates a task with the specified priority and 
stack area. 

Deletes a Job and all the objects currently 
defined within its bounds only if that Job does 
itself not contain any other jobs. All memory 
used is returned to the containing job. 

Deletes a mailbox. 

Deletes the specified segment by deallocating 
the memory. 

Deletes a semaphore. 

Deletes a task from the system, and removes it 
from any queues in which it may be waiting. 

Disables the hardware from accepting interrupts 
at or below a specified level. 

Enables the hardware to accept interrupts from a 
specified level. 

Used by an interrupt handler to relinquish 
control of the System* 

Returns the number of the highest priority 
interrupt level currently being processed. 

Returns attributes such as the minimum and 
maximum, as well as current size of the memory 
in the environment of the calling task*s job. 
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(^T$R1I0RITY 

GET$SIZE 

GET$TAS1$TQKENS 

(^T$TYPE 

LOOKUF$OBJECT 

OFFSPRIliG 

RECEIV1$MESSAGE 

RECEIVE$UNITS 

RE SET$ INTERRUPT 

RESUME$TASK 

SEND$CONTROL 

SEND$MESSAGE 

SEND$UNITS 

SET$INTERRUPT 

SET$POOL$MIN 


Obtains the current priority of a specified task. 

Returns the size (in bytes) of a se^ent. 

Gets the token for the calling task or 
associated objects within its environment. 

Returns a code for the type of object: refered to 
by the specified token. 


Returns a token for the object with the 
specified name found in the object directory of 
the speeffied job. 


Provides a list of all the current Jobs created 
by the specified job. 

Attempts to receive an object from a specified 
mailbox. The calling task may choose to wait 
for a specified number of system time units if 
no object is available. 

Attempts to gain a specified number of units 
from a semaphore. If the units are not 
immediately available, the calling task may 
choose to wait. 

Disables an interrupt level, and cancels the 
assignment of the interrupt handler for that 
level. If an interrupt task was assigned, it is 
deleted. 

Resumes a task. If the task had been suspended 
multiple times, the suspension depth is reduced 
by one, and it remains suspended. 

Relinquishes control of a region. 

Sends an object to a specified mailbox. If a 
task is waiting, the object is passed to the 
appropriate task according to the queuing 
discipline. If no task is waiting, the object 
is queued at the mailbox. 

Increases a semaphore counter by the specified 
number of units. 

Assigns an interrupt handler and, if desired, an 
interrupt task to the specified Interrupt 
level. Usually the calling task becomes the 
Interrupt task. 

Dynamically changes the minimum memory 
requirements of the job environment containing 
the calling task. 
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SET$PRIGEITY 
S IGNAL$ I NTERRUPT 

SLEEP 

SUSPEND$TASK 

UNCATALOG$OBJECT 
WAIT$ I NTERRUPT 

BASIC I/O SYSTEM CALLS 
These are the Basic I/O 
A$ATTACH$FILE 

A$CHANGE$ACCESS 

A$CLOSE 

A$CREATE$DIRECTORY 

A$CREATE$FILE 

A$DELETE $CONNECTION 
A$GET$FILE$ STATUS 
A$OPEN 

A$READ 


Dynamically alters the priority of the specified 
task. 

Used by an interrupt handler to signal the 
associated interrupt task that an interrupt has 
occured. 

Causes a task to enter the ASLEEP state for a 
specified number of system time units. 

Suspends the operation of a task. If the task 
is already suspended^ its suspension depth is 
increased by one. 

Removes an object and its name from a job’s 
object directory. 

Used by an interrupt task to SLEEP until the 
associated interrupt handler signals the 
occurence of an interrupt. 


System calls. 

Creates a connection to an existing file and 
returns its token identifier. 

Changes the types of accesses permitted to the 
specified user(s) for a specific file. 

Closes the connection to the specified file so 
that it may be used again, or so that the type 
of access may be changed. 

Creates a Named File used to store the names and 
locations of other named files, and returns a 
token Identifier for the connection to the new 
file. 

Creates a data file with the specified access 
rights, and returns a token identifier for the 
connection to the new file. 

Deletes the connection to the specified file. 

Returns the current status of a specified file. 

Opens a file for either read, write, or update 
access. 

Reads a number of bytes from the current 
position in a specified file. 
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A$SEEK Moves the current data pointer of a named or 

physical file. 

A$WRITE Writes a number of bytes at the current 

position in a file. 


EXTENDED I/O SYSTEM CALLS 

These are the Extended I/O System calls. 


CREATE$IO$ JOB Creates an I/O job with one task. 

EXIT$IO$JOB Sends a message to a previously designated 

mailbox and deletes the calling task. 


S$ATTACH$FILE 


Creates a connection to an existing file. 


S$CATALOG$CONNECTION Creates a logical name for a connection by 

cataloging the connection in the object 
directory of a specific job. 

S$CHANGE$ACCESS Changes the access list for a named file. 


S$CLOSE 


Closes an open connection to a named, 
physical or stream file. 


S$CREATE$DIRECTORY Creates a new directory file. 


S$CREATE$FILE Creates a new physical, stream, or named 

data file. It cannot create a named 
directory file. 


S$CREATE$IO$JOB 
S $DELETE $CONNECTI ON 

S$DELETE$FILE 

S$EXIT$IO$JOB 

S $GET$C ONNECTION$ S TATUS 


Creates an I/O job containing one task. 

Deletes a file connection. It cannot delete 
a device connection. 

Deletes a stream, physical, or named file. 

Sends a message to a previously designated 
mailbox and deletes the calling task. 

Provides status information about file and 
device connections. 


S$GET$FILE$STATUS Allows a task to obtain information about a 

physical, stream, or named file. 

S$LOOK$UP$CONNECTION Searches through an I/O job’s local, global, 

and root object directories to find the 
connection associated with a logical name. 
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S$OPEN 

S$READ$MOVE 

S$RENAME$FILE 

S$SEEK 
S$ SPECIAL 

S$TRUNCATE$FILE 


Opens a connection to a named, 
physical, or stream file. 

Reads a number of bytes from a file to 
a buffer. 

Changes the path of a named file. It 
cannot be used for stream or physical 
files. 

Moves the file pointer. 

Allows your task to perfom functions 
that are peculiar to a specific device. 

Removes information from the end of a 
named data file. 


S$UNCATALOG$CONNECTION Deletes a logical name from the object 

directory of a specific job. 

S$WRITE$MOVE Writes a collection of bytes from a 

buffer to a file. 


HUMAN INTERFACE SYSTEM CALLS 


These are the Human Interface System Calls. 


C$CREATE$COMMAND$CONNECTION Create a command connection and return 

a token. 


C$DELETE$COMMAND$CONNECTION Delete a specific command connection. 


C$FORMAT$EXCEPTION 


Format a default message into a user 
buffer for a given exception code. 


C$GET$CHAR 


Get a character from the command line. 


C$GET$INPUT$CONNECTION Return an EIOS connection for the 

specified input file. 


C $GE T$INPUT$PATHNAME 


C$GET$OUTPUT$CONNECTION 
C$GE T$OUTPU T$PATHNAME 


Parse the command line return a 
pathname that will identify the 
Standard Input file. 

Return an EIOS connection for the 
specified output file. 

Parse the command line and return a 
pathname that will identify the 
Standard Output file. 
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C$€ET$PAEAMETER 

C$ SEND$CO$RESPONSE 

C$SEND$COMMAND 

C$SEND$E 0 $RESPONSE 

C$SET$CONTROL$C 

C$SET$PARSE$BUFFER 


Parse the command line for the next 
parameter and return it as a Rejn^rord name 
and a value. 

Send a message to the command output (CO) 
and read a response from the command input 
(Cl). 

Concatenate command lines into the data 
structure created by CREATE$COM~ 

MAND$ CONNECTION and then execute command. 

Send a message to the error output device 
(EO) and return a response from the error 
input device (El). 

Change calling program’s CONTROL C 
semaphore to the specified semaphore. 

Parse a buffer other than the current 
command line. 


SYSTEM PROGRAMMER SYSTEM CALLS 


These system calls are considered System Programmer calls because of 
their global effect on the system. 


A$GET$EXTENSION$DATA Returns from the I/O System extension data 

stored with a file. 


A$PHYSICAL$ATTACH$DEVICE Attaches a device to the Basic I/O System. 

A$PHYSICAL$DETACH$DEVICE Detaches a device from the Basic I/O 

System. 

A$SET$EXTENSION$DATA Sets the extension data for a file from 

the I/O System. 


ACCEPT$CONTROL 

ALTER$COMPOSITE 

CREATE$COMPOSITE 
CREATE$EXTENSION 
CREATE $REGION 
CREATE$USER 


Requests access to data protected by a 
region only if access is immediately 
available. 

Alters the component list of a composite 
object. 

Creates a composite object. 

Creates a new extension object type. 
Creates a region. 

Creates a user object. 
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DELETE$COMPOSITE 

DELETE$EXTENSION 

DELETE$REGION 

DELETE$USER 

DISABLE$DELETION 

ENABLE$DELETION 

FORCE$DELETE 

INSPECT$COMPOSITE 

INSPECT$USER 

LOGICAL$ATTACH$DEVICE 

LOGICAL$DETACH$DEVICE 

RECEIVE$CONTROL 

SEND$CONTROL 

SET$OS$EXTENSION 

SET$PRIORITY 

SET$TIME 

SIGNAL$EXCEPTION 


Deletes a composite object. 

Deletes an extension type. 

Deletes a region. 

Deletes a specified user object. 

Increases the deletion disabling depth of an 
object by one. 

Decreases the deletion disabling depth of an 
object by one. 

Forces the deletion of an object even if the 
object has had its deletion disabled once. 

Returns a list of the component object tokens 
contained in a composite object. 

Returns a list of the ID*s in a user object. 

Attaches a device to the Extended I/O System. 

Detaches a device from the Extended I/O 
System. 

Requests eventual access to data protected by 
a region. 

Relinquishes access to data protected by a 
region. 

Allocates and deallocates extension entries 
in the interrupt vector table. 

Changes the priority of a task dynamically. 

Sets the time and the date. 

Signals the occurrence of an exceptional 
condition. 
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APPENDIX C. MONITOR COMMANDS 


The iRMX 86 PC Operating System includes the iSBC 957B Monitor, which 
resides in EPROM on the processor board. This appendix describes the 
Monitor commands, which allow you to do such things as: 

• Set breakpoints in programs 

• Single-step through your programs 

• Examine and modify registers and memory 

• Perform I/O via 8086 input and output ports 

• Move and compare blocks of memory 

Also, by connecting your hardware to an Intel Microcomputer Development 
System (using the iSBC 957B package), you can use the monitor from the 
Development System. Chapter 5, PREPARING YOUR HARDWARE, describes the 
jumpering and devices required on your Single Board Computer to support 
this feature. The USER’S GUIDE FOR THE iSBC 957B iAPX 86, 88 INTERFACE 
AND EXECUTION PACKAGE describes the iSBC 957B package. 

You can get to the monitor in any of these ways: 

• By booting the system (as described in Chapter 2), and when the 
period (. ) prompt is displayed, the Monitor is ready to accept 
commands. 

• By using the Human Interface DEBUG command , specifying a program 
file. This loads a program into memory and gives control to the 
monitor, permitting you to examine the program in detail. The 
DEBUG command is described in Chapter 3. 

• By pressing a button connected to the nonmaskable interrupt of 
your Single Board Computer. This interrupts the application 
system and gives control to the monitor, which prompts with a 
period (.) and waits for your entry. 


CAUTION 

To prevent destroying data on your 
diskettes, wait at least 2 seconds 
after your last iRMX 86 command before 
you interrupt the computer. 


In this chapter, the 8087 Numeric Processor Extension is referred to as 

"NPX.” 
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COMMAND STRUCTURE 

Responses to the monitor's command-level prompt are line-oriented, as 
opposed to the more traditional character-oriented monitor input. This 
allows for command-line editing capabilities. 

Each monitor command includes a key letter, which is suggestive of the 
function of the command, such as D for displaying memory and S for 
substituting memory. Some commands have one or more additional letters 
which specify variations of the general function. 

Following the key letter or letters of a command are zero or more 
arguments. The arguments can be addresses, data, register names, 
strings, or punctuation symbols dpending on the command. 

In the remainder of this manual, the following syntax conventions are 
used: 


[A] indicates that **A’* is optional 

[A]* indicates zero or more optional iterations of "A" 

<B> indicates that **B” is a variable 

{A IB} indicates "A" or ”B” 

<cr> indicates a carriage return 

Variables in commands include numbers, registers, expressions, and 
addresses. The BYTE and WORD variables are defined in the following 
sections. 


BYTE AND WORD VARIABLES 

<dec digit>::= {0| 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8| 9} 

<hex digit>::= {<dec digit> |A|B|C|D|E|F> 

<dec number>: := {<dec digitXdec number>|<dec digit>} 

<hex number>::= {<hex digitXhex number>|<hex digit» 

<number>: := {<hex number>|<dec number>T} 

<register>: := {AX|BX|CX|DX|SP|BP|SI|DI|CS1DS|SS|ES|IP|FL} 
<term>::= {<number>| <register>} 

<expr>: := {<term> |<expr>{+|-}<term>} 

<addr>: := { [ <expr>: ] <expr>} 

<range>: := {<addr> |<addr>#<number>} 

The range of byte values is OO-OFFH. Larger numbers can be entered but 
only the last two digits are significant because the number is evaluated 
modulo 256. The range of word values is OOOO-OFFFFH. Larger numbers can 
be entered, but only the last four hex digits are significant because the 
number is evaluated modulo 65536. Leading zeros can be omitted for both 
types of values. 

Byte and word values are assumed to be in hexadecimal. However, decimal 
values can be entered if they end with a "T". The trailing ”H” that 
sometimes indicates hexadecimal is not allowed for byte or word values. 
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When word values are displayed, the contents of the high byte of the 
address location is displayed, followed by the contents of the low byte 
of the address location. Similarly, when entering word values, the high 
byte is followed by the low byte. If necessary, leading zeros are 
appended to the value by the monitor. Assume, for example, that the byte 
values C4, 26, F2, and 3D are in consecutive locations beginning at 
246 b : 26. A display of those locations in bytes looks like: 

246B:0026 C4 26 F2 3D 

while the corresponding display in words looks like: 

246B:0026 26C4 3DF2 


NUMERIC (REAL, INTEGER AND BCD) VARIABLES 
<sign>: := [{+|-}] 

<npx dec number>: := <signXdec number> 

<npx hex number>: := <hex number >H 

<scientific number>: := {<npx dec number> [.<dec number>]| 

<sign>.<dec number >} [E<npx dec number>] 

<int number>: := {<npx dec number>l<npx hex number>} 

<BCD number>: := {<npx dec number>|<npx hex number>} 

<real number>: := {<scientific number>|<npx dec number>l<hex number>R} 
<npx register>::= {CW|SW|TW|OP|DP} 

<npx stack register>: := ST[({0| 1 | 2| 3| 4] 5| 6| 7}) ] 

Numeric variables refer to the data types supported by the 8087 Numeric 
Processor Extension (NPX). There are three types of numeric variables: 
integer, packed binary coded decimal (BCD), and real. Of these three 
basic types , the integer and real types have three sub-types. All seven 
numeric data types are described in Table C-1. For the remainder of this 
manual, the seven numeric variables are referred to as "NPX data types." 

See the 8086 FAMILY USER'S MANUAL NUMERICS SUPPLEMENT for more details on 
the NPX data types . Also, note the section on "Constants" in the 
8086/8087/8088 MACRO ASSEMBLY LANGUAGE REFERENCE MANUAL. For other NPX 
related details, refer to the Application Note, Getting Started With the 
Numeric Data Processor. 
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Table C-1. NM Data Types 


Data Type 

Explicit 

Suffix 

Bits 

Significant 

Digits 

(Decimal) 

Approximate Range 
(Decimal) 

Word integer 

H 

16 

4 

-32,768 < X < +32,767 

Short integer 

H 

32 

10 

-2x10^ < X < +2x10^ 

Long integer 

H 

64 

19 

-9xl0lS < X < +9 x1018 

Packed decimal 

H 

80 

18 

-99.. 99 < X < +99.. 99(18 digits) 

Short real* 

R 

32 

6-7 

8.43x10“^^ < |X| < 3.37x10^^ 

Long real* 

R 

64 

15-16 

4.19x 10“307 < |X| < 1. 67x10^08 

Temporary real 

R 

80 

19 

3.4x10“^929 < |X| < 1.2x10^929 


The short and long real data types correspond to the single and double 
precision data types defined in other Intel numeric products. 


The suffixes used when entering the NPX data types differ from the 
suffixes for word and byte variables. If the no suffix is given when 
entering an NPX data type, the number is assumed to be a decimal number. 

A decimal number is defined for the real NPX data types as a value 
entered as a scientific number. This allows values like 4, 1.2, -1.2, 
-.3, -.3E-44, -1.56E-999 or 5.67E55 to be entered. A decimal number is 
defined for the integer and BCD NPX data types as a value entered as a 
scientific number that will evaluate to an integer value. This allows 
numbers like 12, -12, 4E2 or 4.0E1 to be entered but won't allow the 
entry of numbers like 1.2, -1.2 or -1.56E-999. In the valid cases, the 
monitor will place the hexadecimal equivalent of the input decimal number 
into iAPX 86, 88 memory. However, if an integer or BCD number is entered 
with its explicit suffix "H" or a real number is entered with its 
explicit suffix "R”, the monitor places the number, as it is entered at 
the console, into iAPX 86, 88 memory. In this case explicit signs 
(+ or -) are not allowed, the hexadecimal number, entered at the console, 
indicates the sign of the number in the sign bit, the most significant 
bit. 
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When NPX data types are displayed, the address of the data type is 
displayed and then the value is displayed in hexadecimal form. The 
number is then displayed as the equivalent decimal number if it has an 
equivalent decimal value. For example, the long real number 11223344, is 
displayed in form: 

1111:0 4165682600000000R 1 1223344 

The long integer, 11223344, is displayed in the form: 

1111:0 0000000000AB4 130H 1 1223344 

The BCD number, 11223344, is displayed in the form: 

1111:0 0000000000001 1223344T 1 1223344 

In the remainder of this manual this display form is referred to as "NPX 

number format". If the memory value is a special bit pattern identifying 

non-numeric values like Not-A-Number (NAN) or Infinity, the address and 
the hexadecimal number are displayed and then the meaning is shown as NAN 
or Infinity instead of the decimal value. Examples of these displays 
using a long real number are: 

0080:0000 FFFFOOOOOOOOOOOOR -NAN 

0080:0008 7FF0000000000000R +Infinity 

Special cases of numeric values are also identified. A negative zero is 
dislayed as -0. Ps eudo zeroes (zero fraction with non-zero exponent) are 
shown as OEexp, where exp is the base 10 power equivalent of the binary 
exponent in the number. Numbers which are not normalized (I bit is zero) 
are displayed with their hexadecimal value and a "Bit" value which is a 
count of how many leading zeroes existed in the number. This "Bit" value 
indicates how many times the fractional part of the number must be 
shifted to the left to normalize it. An example of this display using a 
ten5>orary real number is: 

0080:000 3FFF199999999999999AR .2 UNNORM 3 BITS 

Decimal values can be displayed in any of four different formats. The 
format used depends on the range of the number and its value. Numbers 
which are exact integers and fit in the field size of 16 digits are 
displayed as integers with no trailing decimal point or 0. An example of 
this display using a long real number is: 

0080:0000 43118B54F22AEB00R 1234567890123456 

Values which appear as integers, within the limits of the field size, but 
are not exact integers are displayed as XXXXX.O. The .0 suffix indicates 
that the value is close to an integer but not exactly. An example of 
this display using a xong real number is: 

0080:0000 42DC12218377DE46R 123456789012345.0 
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If the magnitude of a number is greater than or equal to 0.1 and is less 
than 10**<field size>, the number is displayed as XXXX.XXX. An example 
of this display using a long real number is: 

0080:0000 41D26480B487E69BR 1234567890.12345 

Finally, very large or very small numbers are displayed in scientific 
number format X.XXXXXEexp. An example of this display using a long real 
number is: 


0080:0000 492C2916217B84B7R 3.14E+44 

Trailing zeroes after the decimal point are also suppressed. 

When NPX data types are displayed, the most-significant byte of the 
memory address (in hexadeximal notation) is displayed in the leftmost 
position, followed by bytes of decreasing significance with the least 
significant byte in the right most position. Similarly, when entering 
NPX data types in hexadecimal or decimal, the first digit entered has the 
greatest significance and successive digits entered have decreasing 
significance. If less than the NPX data type's number of significant 
digits is entered, the monitor will append leading zeros. When entering 
a value for an NPX date type in scientific number format, the number is 
converted to its hexadecimal equivalent and is then stored in iAPX 86, 88 
memory in that format. 


ADDRESS SPECIFICATION 

A conq>lete address argument consists of a base and an offset separated by 
a colon (:)• If the optional base portion is omitted, the contents of 
the iAPX 86, 88 CS register are used as a default base, except as noted 
in the command descriptions that follow. If an entire address is 
omitted, but an address is needed in the command, the contents of the CS 
and IP registers are used, respectively, as base and offset, except as 
noted in the command description. 

There are two ways of denoting a range of addresses. One way is to list 
both the starting and ending addresses, with an exclamation point between 
them. An example is 30:46D ! 30:4FE. The other way is to list the 

starting address and the length in bytes, with a pound sign (#) between 

them. An example equivalent to the earlier one is 30:46D # 92. 

If the ending address in a range lacks an explicit base part, the base of 
the starting address is assumed. The ending address may not contain a 
base part which differs from the base part of the starting address. 

The largest count or the maximum number of bytes specified by a range is 

OFFFFh. When a range is expected and neither an ending address nor a 

length is specified, the range is taken to be a single byte. 
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MULTIPLE COMMANDS ON A SINGLE LINE 

There are two mechanisms for putting more than one command on a comoiand 
line* First, separate commands may be in the same command line if they 
are separated by semicolons (;)• Second, by enclosing a command in angle 
brackets (<command>) and by placing a decimal repetition factor ahead of 
the first bracket, you can specify that the command be repeated the 
desired number of times. A repetition factor of n says ”do this command 
n times.” For example, 

5 <12 <G, CS:3B7> ; D DS:4A> 

is a valid command line that is built from the commands G, CS:3B7 and D 
DS:4A. The command G, CS:3B7 is repeated 12 times, then the D DS:4A is 
performed once. This entire sequence is repeated 5 times so the G, 

CS:3B7 command is repeated at total of 60 times while the D DS :4A command 
is repeated a total of only 5 times. Note that this use of angle 
brackets is NOT the same as the use of angle brackets in the syntax 
definition. 

Closely related to repetition, but differing, is continuation. By 
putting a decimal continuation factor, n, immediately ahead of a 
command's key letter or letters, you are directing the monitor to ”do 
this command for n items at a time.” For example, the command D 200:14 
directs the monitor to display the byte at address 200:14, while 20D 
200:14 causes the display of 20 consecutive bytes, beginning at address 
200:14. In contrast, 20 <D 200: 14> causes the byte at 200:14 to be 
displayed 20 times. 


NOTE 

Both repetition and continuation 
factors are written as positive decimal 
integers with no ”T” suffix. The range 
of these factors is 1 through 65,535. 

In any other part of a command using 
byte or word variables, however, 
decimal integers must have a ”T” 
suffix, such as 127T. 
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iAPX 86 AND lAPX 88 GPU REGISTERS 

The iAJ^X 86 and iA.PX 88 GPUs include the 14 registers listed in Table 
C-2. The abbreviations used in the table are those used in the Gommand 
syntax# 

Table C-2. iAPX 86, 88 CPU Registers 


Register Name 

Abbreviation 

Accumulator 

AX 

Base 

BX 

Count 

cx 

Data 

DX 

Stack Pointer 

SP 

Base Pointer 

BP 

Source Index 

SI 

Destination Index 

DI 

Code Segment 

CS 

Data Segment 

DS 

Stack Segment 

SS 

Extra Segment 

ES 

Instruction Pointer 

IP 

Flag 

FL 


NPX REGISTERS 


The NPX includes the eight 80-bit individually -addressable stack 
registers plus the status word, control word, tag word, instruction 
pointer, data pointer and instruction opcode field listed in Table C-3. 
The abbreviations used in the table are those used in the command 
syntax. Note that the NPX instruction pointer listed in Table C-3 is not 
the iAPX 86, 88 instruction pointer. The monitor contains no command to 
modify the NPX instruction pointer. 
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Table C-3. NPX Registers 


Register Name 

Abbreviation 

NPX State 

N 

Status Word 

sw 

Control Word 

cw 

Tag Word 

TW 

Instruction Pointer 

IP 

Data Pointer 

DP 

Instruction Opcode 

OP 

Stack Register 0 

* 

St(0) 

* 

* 

* 

Stack Register 7 

. 

St(7) 


ERRORS 


Each line input to the monitor is checked for validity. If the command 
is invalid or impossible to execute, an explanatory error message is 
displayed* If the command line containing the error consists of multiple 
commands, any valid commands prior to the error are executed. 

Three error messages - ”Bad EMDS Connection”, ”Bad Patch Byte=hex 
number”, and XISIS Abort” - are all indicative of hardware problems. To 
recover, check your hardware, restart monitor, and try again. 


ENTERING COMMANDS 


The monitor's command line editor responds to input as follows: 

• Digits, upper and lower case letters, and all other standard 
keyboard characters are accepted into the command line and are 
printed on the console. Upper and lower case letters are 
indistinguishable to the monitor, all display is done by the 
monitor in upper case. 

• RUBOUT deletes the most recently entered character (with 
backspace, space, backspace) from both the command line and the 
display. An attempt to rubout the prompt causes a beep to be 
sounded. 
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• CNTRL/C directs the monitor to abort its current command and 
issue a prompt. However, if your program is running and is in a 
loop, CNTRL/C has no effect. 

• CNTRL/R displays at the console the current command line. If the 
console terminal is in transparent mode, however, control-R has 
no effect. 

• CNTRL/X deletes the current command line and displays a pound 
sign (#). 

. CNTRL/S causes the console output to be suspended at the current 
cursor position. No output is lost by this command. 

• CNTRL/Q causes the console output, suspended by Control-S, to be 
resumed beginning at the current cursor position. 

• CARRIAGE RETURN (CR) signals the completion of the command line, 
which is then read and acted upon. 

• Other characters have no effect. Spaces may be included anywhere 
in the command line except within lexical elements. 

• NPX data types may be entered only on the substitute (*'S") or 
**XST(n)" command line and may appear in no other command line. 

Command lines may be up to 255 characters in length. An attempt to 
exceed this limit will be unsuccessful and will cause the terminal to 
beep. 
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COMMAND DESCRIPTIONS 


The Monitor commands are summarized in Table C-4. 


Table C-4. Summary of Loader And Monitor Commands 


L 

G 

R 


T 


N 

X 


D 

S 


M 

F 

C 


COMMAND 


FUNCTION AND SYNTAX 


Load 


Loads an absolute object file from Intellec into iAPX 
86, 88 memory* L <filename> <cr> 


Go Transfers control of the CPU to the user program. 

G [<s tart-addr> ] [, <break-addr> |<range> ]<cr> 

Load and Go Loads an absolute object file from Intellec into iAPX 
86, 88 memory and begins execution. 

R<f ilenameXcr> 


Upload 


Loads a block of iAPX 86, 88 memory into an Intellec 
file. 

T<range> , <filename> [, <s tart-addr>]<cr> 


Single Step Displays and executes one instruction at a time. 

[<cont>] N [0] [P] [Q] [<start~addr>] [, ]<cr> 

Examine Displays or modifies iAPX 86, 88 or NPX registers. 

X[ <reg>[=<expr>] ]<cr> 

X{N| [<iipx register>[=<hex number>]] | 

[ <npx stack register> [=<real number > ] ] } <cr> 


Display 


Displays contents of a memory block. 

[<cont>] D [{W|I1SI|LI|T|SR|LR|TR|X}] [<range>] [ , ]<cr> 


Substitute 


Displays/modifies memory locations. 

[<cont>] S [W]<addr>[=<expr>] [/<expr>]*[, ]<cr> 
[<cont>] S [ {I|SI |LI} ] <addr>[=<int number>] 
[/<int number> ]*] , [<cr> 

[<cont>] S [ {SR|LR|TR}] <addr>[=<real number>] 
[/ <real number> ] * [ , ] <cr> 

[<cont>] S [T]<addr>[=<BCD number>] [/<BCD 
number > ] * [ , ]<c r> 


Move 


Find 


Compare 


Moves the contents of a memory block. 
M<range> , <dest-addr><cr> 

Searches a memory block for a constant. 
F<range> , <dataXcr> 

Compares two memory blocks. 

C<range> , <dest-addrXcr> 


C-11 






MONITOR COMMANDS 


Table C-4, Summary of Loader And Monitor Commands (continued) 


COMMAND I FUNCTION AND SYNTAX 


I Input Inputs and displays data from input port. 

[repeat] I [W] <port-addrXcr> 

0 Output Outputs data to output port. 

[repeat] 0 [W] <port^ddr> , <data> <cr> 

P Print Prints values or literals. 

P [ {T| S IQ} ] [ {<addr>| <expr>| <literal>} ] [, 

{<addr> |<expr> |<literal>} ]*<cr> 

E Exit Exits the loader program and returns to ISIS-II. 

E<cr> 

* Comment Rest of line is a comment. 

* <commentXcr> 

B Bootstrap Bootstraps code from iRMX 86 or 88 file compatible 
peripherals. 

B[ <pathname>] 
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Basic I/O System B-2 
Bootstrap Loader 2-2, B-2 
bootstrap loading 1-11, 2-2 
BYTE 4-3 

comment (command) 2-5 
CONNECTION 4-3, 4-5 
continuation mark (command) 2-5 
CONTROL keys 2-6 

COPY command 2-14 to 2-17, 2-18, 3-15 to 3-17 
copying system diskette 2-19 
CREATEDIR 2-17, 3-18 to 3-19 

DATE command 2-8 to 2-10, 3-20 
DEBUG 3-21 
DELETE 3-22 to 3-23 
DETACHDEVICE 3-24 

DIR command 2-12 to 2-14, 3-25 to 3-31 
directory 1-7 
DISKVERIFY 3-32 to 3-36 
documentation 6-1 to 6-7 
DOWNCOPY 3-37 to 3-39 

EDIT 1-4 

EPROMs iv, 5-9, 5-11, 5-13 

exception codes 4-2, A-1 to A-7 
exception handlers 1-12 
exception-handling system calls 4-6 
Extended I/O System B-2 

file 1-6 

file handling system calls 4-5 
file operations from a program 1-8 
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file operations from terminal 1-8, 2-1 
file system 1-5 
FORMAT 2-19, 3-40 to 3-44, 5-3 
FORTRAN 1-4 


hardware 1-2 

heirarchical file structure 1-5 
Human Interface 3-1, B-2 


INCLUDE files (iRMX 86) 1-11 

INCLUDE files (UDI) 4-2 
inpath-list (command) 2-4 
interleave factors 2-19, 3-41, 3-43 
invoking commands 2-3 to 2-18 
iRMX 86 Operating System 1-1 
iRMX 86 PC Operating System 1-1 
iRMX 86 PC Release Package iv 

iSBC^ 208 Flexible Diskette Controller 1-3, 5-3, 5-6 , 5-18 
iSBC" 337 Numeric Processor Extension 5-5 
ISBC^ 86/12A Single Board Computer 1-3, 5-7 to 5-9, 5-15 
ISBC 86/14 Single Board Computer 1-3, 5-10 to 5-11 , 5-16 
iSBC" 86/30 Single Board Computer 1-3, 5-12 to 5-13, 5-17 
ISBC™ 957B package 1-3 


layers of iRMX 86 Operating System 1-1 
LIB86 1-4 

Library Diskette iv, 1-11 

line printer 1-3, 5-4, 5-18 

line printer signals (Centronics) 5-4, 5-18 

LINK86 1-4 

LOC86 1-4 

logical name 1-7 


manuals 6-1 to 6-7 
memory 1-3 

memory -management system calls 4—4 
monitor 1-12, C-1 to C-12 

Nucleus layer B-1 
outpath-list (command) 2-4 
overlays 4-30 to 4-31 
parameters (command) 2-4 
parsing 4-20 to 4-21 
Pascasl 1-4 
pathname 1-7 
PL/M-86 1-4 

POINTER 4-3 

PROG (program directory) 1-10 
program (example) 4-44 to 4-48 
program loading 1-11 
proposition (command) 2-4, 2-5 

RENAME command 2-18, 3-45 to 3-47 
RESTORE 2-19, 3-48 to 3-54 
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segment 4-4, 4-9 to 4-10, 4-11 
SELECTOR 4-3 

SHORT parameter in DIR command 2-14, 3-25 

special characters 4-20 

STRING 4-3 

SUBMIT 3-55 to 3-57 

syntax diagrams 3-1 to 3-2 

SYSTEM (system directory) 1-10 

system call dictionary 4-7 to 4-8 

system calls (iRMX 86) B-1 to B-9 

system calls (UDI) 4-1 to 4-48 

System Diskette iv, 1-9 

TIME command 2-8 to 2-10, 3-58 
TOKEN 4-3 

transparent mode (terminal input) 4-37 to 4-38 

UDI 1-5, 4-1 to 4-48 

UDI system calls 4-9 to 4-48 

Universal Development Interface (UDI) 1-5, 4-1 to 4-48 
UPCOPY 3-59 to 3-60 

video terminal 1-3 
volume 1-6 

WORD 4-3 

WORK (work directory) 1-10 


Indexr3 




iny 


Getting Started with 
the iRMX’’”86 System 
144349-001 


REQUEST FOR READER’S COMMENTS 

Intel Corporation attempts to provide documents that meet the needs of all Intel product users. This form lets 
you participate directly in the documentation process. 

Please restrict your comments to the usability, accuracy, readability, organization, and completeness of this 
document. 

1. Please specify by page any errors you found in this manual. 



2. Does the document cover the information you expected or required? Please make suggestions for 
improvement. 



3. Is this the right type of document for your needs? Is it at the right level? What other types of documents are 
needed? 



4. Did you have any difficulty understanding descriptions or wording? Where? 



5. Please rate this document on a scale of 1 to 10 with 10 being the best rating. 

NAME 

TITLE 

COMPANY NAME/DEPARTMENT 

ADDRESS 

CITY 


DATE 


STATE ZIP CODE 


Please check here if you require a written reply. □ 







WE’D LIKE YOUR COMMENTS . . . 


This document is one of a series describing I ntel products. Your comments on the back of this form 
will help us produce better manuals. Each reply will be carefully reviewed by the responsible 
person. All comments and suggestions become the property of Intel Corporation. 


NO POSTAGE 
NECESSARY 
IF MAILED 
IN THE 

UNITED STATES 


BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO. 79 BEAVERTON, OR 


POSTAGE WILL BE PAID BY ADDRESSEE 

Intel Corporation 

5200 N.E. Elam Young Pkwy. 

Hillsboro, Oregon 97123 



O.M.S. Technical Publications 




INTEL CORPORATION, 3065 Bowers Avenue, Santa Clara, California 95051 ( 408 ) 987-8080 

Printed in U.S. A. 



